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HOW TO USE THE REALITY® MANUALS 



The Reality® manuals are written in modular format with each pair of facing 
pages presenting a single topic. 



This and other Reality manuals differ substantially from the typical reference 
manual format. The left-hand page of each topic is devoted to text, while the 
right-hand page presents figures referred to by the text. At the head of each 
text page are a pair of titles, the first title naming the section, the second 
the topic. Immediately below these titles is a brief summary (boxed) of the 
material covered in the topic. 

The advantage of this format will become readily apparent to the reader as he 
uses this manual. First, the figures referred to in the text are always con- 
veniently right in front of the reader at the point where the reference is made, 
Secondly, the reader knows that when he turns the page, he has completed one 
idea and is ready to encounter a new one. 

Documentation for the Reality system includes the following: 

Reality Programmer's Reference Manual, #1048 

Reality EDITOR Operator's Guide, #1052 

Reality ENGLISH'^-'^- Programming Manual, #1038 

Reality DATA/BASIC^.m^ Programming Manual, #1051 

Reality PROC and BATCH Programming Manual, #1044 

Reality Assembly Language Programming Manual, #1049 

Reality Bisync Operator's Guide, #104 3 

The examples throughout this manual use certain conventions as defined in 
Figure A. 



C ONVENTION MEANING 

TEXT , Shaded text represents the user's input, 

TEXT Standard text represents computer output 

printed by the system, 

TEXT Italioized text is used for comments and notes 

which help explain or describe the example, 

(^^ This symbol represents a carriage return, 

Y> This symbol represents a space (blank). 



Figure A. Conventions Used Throughout This Manual 



1 INTRODUCTION 

1.1 THE PROC AND BATCH PROCESSORS 



This manual describes two processors which are implemented on Microdata's 
Reality® Computer System: the PROC (stored procedure) processor and the 
BATCH update processor. 



The PROC processor allows the user to prestore a complex sequence of Terminal Con- 
trol Language (TCL) operations (and associated processor operations) v/hich can 
then be evoked by a single word command. Any sequence of operations which can be 
executed at the TCL level can also be prestored via the PROC processor. This pre- 
stored sequence of operations (called PROC) is executed interpretively by the PROC 
processor and therefore requires no compilation phase. 

The PROC processor has the following features : 

Four variable length I/O buffers 

Parameter passing between buffers 

Interactive terminal prompting 

Extensive I/O and buffer control commands 

Conditional and unconditional branching to optional command labels 

Relational character testing and pattern matching 

File accesses and updating 

Free-field and fixed-field character manipulation 

Formatted screens and printouts 

PROC calculations 

Inter-PROC linkage and subroutines 

The BATCH processor provides a facility for inputting, updating, verifying, and 
deleting items (or attributes) within Reality files. The BATCH processor oper- 
ates via a predefined "BATCH-string" and a subsequent input line. The BATCH- 
string provides the dictionary function for the file update. In other words, the 
BATCH processor ignores the attribute defining items defined for the designated 
files (i.e., attributes which are used by the ENGLISH® language processor), and 
instead relies on the BATCH-string to define the updating algorithm. This pro- 
cessor is largely replaced by DATA/BASIC, but is maintained for compatibility. 



The BATCH processor includes the following features: 
Simultaneous update of multiple files 
Reversal of update function via same BATCH-string 
Input prompting 
Free-field and fixed-field character referencing 

BATCH-lock capability protecting against concurrent BATCH- 
string access 

Interactive update capability when used in conjunction with 
a PROC 

It is assumed that the user has read and understood the document titled 
"INTRODUCTION TO REALITY" prior to referencing this manual. A general 
understanding of the material covered in the "REALITY PROGRAMMER'S 
REFERENCE MANUAL" will also prove useful in comprehending the finer 
points of this manual. 



1.1 



1 INTRODUCTION 

1.2 HOW TO USE THIS MANUAL 



This manual is written in modular format with each pair of facing 
pages presenting a single topic. 



The approach in this and other Reality manuals differs substantxally from 
the typical reference manual format. Here each pair of facing pages 
discusses an individual topic. Generally the left-hand page xs devoted 
to text, while the right-hand page presents figures referred to by the 
text. At the head of " each text page are a pair of titles, the first one 
naming the section and the second one naming the topic. Immediately below 
these titles is a brief sumir.ary of the material covered m the topic. 

The advantage of this format will become readily apparent to the reader 
as he begins to use this mar.ual. First of all, the figures referred to 
in the text are always conveniently right in front of the reader at the 
point where the reference is made. Secondly, there is a psychological 
advantage to the reader in knowing that, whe he has completed reading a 
topic and goes to turn the page, he is done with one idea and ready to 
encounter a new one. 

subsequent sections of this manual describe various PROC and BATCH elements, 
in presenting general formats and examples relating to these elements, cer- 
tain conventions apply- Conventions used in presenting general formats 
are listed in Figure A, while conventions used in examples are listed m 
Figure B. 

. -. u K=.v-c= ^v^ fnr the convenience of present Reality users and I 



CONVENTION 



:meaning 



UPPER CASE 



lower case 



{} 



{}.. 



Characters or words printed in upper case are 
required and must appear exaotly as shown. 

Characters or words printed in lower case are 
parameters to he supplied by the user (e.g._, 
file name J oolumn number^ data^ etc.). 

Braces surrounding a word and/or parameter 
indicate that the word and/ or parameter is 
optional and may be included or omitted at 
the user 's option. 

If an elipses (i.e.^ three dots) follows the 
terminating bracket^ then the enclosed word 
and/or parameter may be omitted or repeated 
an arbitrary number of times. 



Figure A. Conventions Used in General Formats 



CONVENTION 



MEANING 



TEXT 
TEXT 



Shaded text represents the user's input. 

All other text represents output printed by 
the system. 

This symbol represents a carriage retiArn. 



Figure B. Conventions Used in Examples 



(Significant textual changes are indicated by a vertical bar such as 
the one at the right. ) 



Figu2:e C, Change Bar Format 
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2 THE PROC PROCESSOR 

2.1 AN INTRODUCTION TO PROC'S 



An integral part of the Reality Computer System is the ability to define 
stored procedures called PROC'S. 



A PROC provides the applications programmer a means of cataloging a highly complex 
sequence of operations which can then be evoked from the terminal by a one word 
command. Any operation that can be executed by the Terminal Control Language can 
be performed in a PROC. This usage of a PROC is quite similar to the use of a Job 
Control Language (JCL) in some large-scale computer systems. The PROC language 
in Reality, however, is more powerful since it has additional capabilities, and 
can be used to interactively prompt the terminal user. Additionally, a PROC can 
test and verify input data as they are entered from the teiminal keyboard. Fur- 
thermore, the ability to access and update files from PROC makes PROC an exceed- 
ingly flexible tool . 

A PROC is stored as an item in a dictionary or data file. The first attribute 
(first line) of a PROC is always the code PQ. This specifies to the system that 
what follows is to be executed by the PROC processor. All subsequent attribute 
values contain PROC statements that serve to generate TCL commands or insert 
parameters into a buffer for the interactive processors, such as the EDITOR or 
the BATCH processor. PROC statements consist of an optional numeric label, a 
one- or two-character command, and optional command argioments . 

Typically, PROC's are created using the EDITOR. PROC ' s are executed interpre- 
tively by the PROC processor and therefore require no compilation phase. (An 
optional compilation can be used to speed up PROC's.) A PROC stored as an item 
in the user's Master Dictionary (M/DICT) is executed in the TCL environment by 
typing the item-ID of the PROC, any optional arguments, and a carriage return. 
This is illustrated in Figure A where the sample PROC named LISTU is evoked. The 
ability to pass arguments to a TCL level process via a PROC is illustrated in 
Figure B. Here LISTDICTS is the name of the pre-stored PROC, while POLICY is the 
argument being passed. 

The ability to interactively prompt input data from the user (and subsequently 
verify these data) is illustrated in Figure C. Here the PROC named ENTER-DATA 
is evoked. The PROC then prompts the user for the required data. The PROC could 
then, for example, store these data in a buffer which would then be passed to the 
BASIC processor to update the file. 

Once a PROC is evoked, it remains in control until it is exited. When the PROC 
temporarily relinquishes control to a processor such as the EDITOR or a user- 
supplied subroutine, it functionally remains in control since an exit from the 
called processor returns control to the PROC. TCL only regains control when the 
PROC is exited explicitly, or when all of the lines in the PROC have been ex- 
hausted. 



:LISTU 


(CR) 








CHANNEL 


PCB-FID 


NAME 


. DATE 


TIME. . 


THREE 


0260 


Ki!^RDEX 


14 SEPT 19 77 


12:38 


ELEVEN 


0360 


EARL 


14 SEPT 1977 


14:01 


TWO 


0240 


EARL 


14 SEPT 19 77 


14:02 


ZERO 


0200 


SYSPROG 


14 SEPT 19 77 


14:15 



Figure A. Sample PROC Execution 



:LISTDICTS POLICY (CR) 
POLICY D/CODE , 



AUDIT-PERIOD 
POLICY-PERIOD-FROM 
POLICY-PERIOD-TO 
EXPIRES 



A 


01 




A 


02 


D 


A 


03 


D 


A 


03 


D 



A/AMC . V/CONV V/TYP V/MAX 



L 4 

L 10 

L 11 

L 12 



Figure B. Sample PROC Execution (Argument Passing) 



: ENTER- DATA (S|D 






PART-NUMBER 




= 3215-19 (g^) 


DESCRIPTION 




= TRANSISTOR (CR) 


QUANTITY 




= FIFTY (CR) 


ERROR : NUMERIC DATA 


ONLY! 


1 


QUANTITY 




= siiiiiiiii 



Figure C. Sample PROC Execution (Interactive Prompting) 



2.1 



2 THE PROC PROCESSOR 

2.2 INPUT/OUTPUT BUFFER OPERATION 



Operations specified within a PROC involve the movement of data from either of 
two input buffers to either of two output buffers. 



PROC's utilize four input/output buffers: the primary input buffer, the secondary- 
input buffer, the primary output buffer, and the secondary output buffer (called 
the stack) . See Figure A. Essentially, the function of a PROC is to move data 
from either input buffer to either output buffer,' thus forming the desired TCL 
and processor commands. 

The primary input buffer contains the PROC name and any optional arguments, ex- 
actly as they were entered when the PROC was evoked. The contents of this buffer 
remain the same whenever processors are called. This buffer is typically used for 
terminal input, and for storing parameters which control the sequence of PROC exe- 
cution. Commands in DATA/BASIC allow this buffer to be altered. 

The primary output buffer holds the command which ultimately is submitted at the 
TCL level for processing. Any command which can be executed via the terminal at 
the TCL level can also be constructed and executed via a PROC. 

The secondary input buffer contains data input from the user in response to an IN 

command. The data in this buffer are volatile and are overwritten by subsequent 

IN commands. This buffer has fallen into disuse, but is maintained for compati- 
bility. 

When all desired data have been moved to the secondary output buffer, control is 
passed to the primary output buffer via a P or PP command. The command which re- 
sides in the primary output buffer is executed at the TCL level and the data in 
the secondary output buffer (if any) is used to feed processors such as BATCH or 
EDITOR. When the process is completed, control returns to the PROC, at which time 
new data may be moved to the output buffers . 

Data in the input and output buffers is in the form of a series of parameters 
separated by blanks or attribute marks. References to a parameter in one of 
these buffers is made via the sequential number of that parameter within the buf- 
fer or by the starting character within the buffer. Thus we refer to the sixth 
parameter in the primary output buffer or the data starting in column 16 of the 
secondary input buffer (counting from "1" in both cases) . 

There are three pointers, one into the input buffers and two into the output 
buffers. These are indicated by -f in Figure A. The pointer into the input 
buffers points into whichever is "active" (next paragraph) . This pointer 
may be moved back and forth without affecting the data in the buffer. Each out- 
put buffer has its own pointer which always points to the end of data in those 
buffers. If the pointer is moved backward, the data to the end of the buffer 
will be cleared. 

At any given time, one of the input buffers is specified as "currently active", 
and one of the output buffers is specified as "currently active." The input 
pointer always points into the input buffer which is active. When the PROC is 



I 



I 



entered, or after the TCL process returns to the PROC, the primary input buffer 
IS active and the primary o^utput buffer is active. Having the "stack on" or the 

stack off" is an alternate way of referring to the secondary output buffer being 
active versus the primary output buffer being active. Buffers are selected as 
"currently active" via certain PROC commajnds. When data is moved by the 
A command, it is moved from the position of the input pointer to the position 
of the output pointer in the buffer which is active. 

As an illustration of this concept, consider Figure A. Here the PROC has been 
evoked by the characters ABC XYZ, which are then automatically placed in the pri- 
mary input buffer. PROC co:nnmands have then been processed which position the 
input pointer of the primary input buffer to the second parameter (XYZ) , and then 
subsequently move that parameter to the primary output buffer as illustrated in 
Figure A. In this example the currently active buffers are the primary input 
buffer and the primary output buffer. 

The user should note that each line of data placed in the secondary output buffer 
must be terminated by a carriage return which is explicitly placed in the stack 
as part of an H command (refer to the topic describing that command). This is not 
the case with the primary output buffer; a carriage return is automatically placed 
at the end of the TCL command in the primary output buffer upon execution of that 
buffer via the P or PP command. 



PRIMARY INPUT BUFFER 



PRIMARY OUTPUT BUFFER 



ABC XYZ 



3 



XYZ 



SECONDARY INPUT BUFFER 



SECONDARY OUTPUT BUFFER 



Figure A. Sample Inter-Buffer Transfer With Both Primary Buffers 
Currently Active 



2 THE PROC PROCESSOR 
2.3 BUFFER DELIMITERS 



PROC enhancements required a change in the buffer delimiter from blank 
to attribute mark. The old commands use blank to maintain compatibility. 



Recent enhancements to the PROC processor have required the capability 
to delimit parameters with some character other than blank. The attribute 
mairk has now been implemented as the new buffer delimiter. The major 
advantage is the ability to have null parameters^ parameters which 
contain imbedded blanks, and parameters which match the format of REALITY 
file items . 

In order to provide upward compatibility, the original PROC commands which 
use the blank as the parameter delimiter have not been changed. New 
commands (type 'N') have been added to take advantage of the attribute 
mark as the parameter delimiter. Commands which cause the buffer pointer 
to move leave the pointer pointed to an attribute mark. While 
combinations of the original commands and the new commands are allowed, 
the two sets are designed to work as two distinct alternatives. 

See Figure A for some comparisons of the commands. 



A 
NA 

F 

NF 
B 

NB 
IP 

NIP 

IH 

NIH 

BO 
NBO 

I^ote: 



Moves from the first non-hlank to the first blank. 

Moves from one attribute mark to the next including imbedded 

Moves the pointer forward to the first character of the next 
parameter. 

Moves the pointer forward to the next attribute mark. 

Moves^ the pointer backward to the first character of the 
prevvous parameter. 

Moves the pointer backward one attribute mark. 

Moves data into the current input buffer location with imbedded 
blanks preserved. 

Moves data into the current input buffer location but replaces one 
or multrple consecutive blanks with a single attribute mark. 

Moves the character string which follows into the current pointer 
pos%t%on. ^ 

Moves the character string which follows into the current pointer 
^Zt ■l''1' pepZa^in^ each set of one or more blanks with a sinqle 
attribute mark . ^ 

Moves the^ output buffer pointer back to the first character of 
the prevzous parameter. 

Moves the output buffer pointer back to the previous attribute 
All positions are relative to the applicable buffer pointers. 



Figure A. Comparison of Original and New Commands 
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2 THE PROC PROCESSOR 

2.4 FILE BUFFERS AND SELECT REGISTERS 



The nine file buffers are used for reading and writing records. The five 
select registers are used to hold the results of SELECTS or SORT SELECTS. 



The data within a file buffer is divided into attributes separated by attribute 
marks. Reference to an attribute beyond those already established will cause 
automatic construction of the required number of additional attributes. 

File buffers are referenced by using an ampersand (&) followed by the file buffer 
number, a period (.) and a numeric value. The period is used as a separator and 
the numeric value is the attribute number; references the item-ID. File buffers 
may not be used until opened. See the section on file commands. 

The maximum size of a file buffer is 32,267 bytes. 

Select registers are used when processing the results of a SELECT or SSELECT, or 
for handling multi-valued attributes. Any of the five select registers may con- 
tain only one attribute at any time. The attribute may be of any size and may 
contain multi-values. See the topic SPECIAL VERBS FOR USE WITH PROC: THE PQ- 
COMPILE AND PQ-SELECT VERBS. 

The select registers are referenced using an exclamation mark (!) followed by the 
number of the register. Each reference to a select register obtains the next 
value (item-ID) for processing. If a value is to be used more than once, it 
should be moved to another buffer. 

Any new values added to a select register cause all previously existing values to 
be deleted. 

Figure A presents some examples of the file buffer concept. Figure B presents an 
example of the general form for select register reference. 



1 



PARAMETER # 


BUFFER #1 





1234 


1 


SMITH 


2 


1260 


3 


487-30-7914 


4 


12 SEPT 44 


5 


M 



N 



&1.1 
&1.4 
&2.3 
&2.0 

&F.A 



BUFFER #2 

100 

1234 

480 

80 

3235 

3242 



BUFFER #n 



Referenoes the value "SMITE" in buffer #1. 

Referenoes the value "12 SEPT 44" in buffer §1. 

References the value "80" in buffer #2, 

References the value "100" in buffer #2, 

& = File buffer reference. 

F = File buffer number. 

. = Separator. 

A = Attribute number referenced. 



Figure A. File Buffers Concept 



!n ! = Select 


regie 


ter 


reference . 






n = Select 


regis 


ter 


number. 






SELECT REGISTER CONTENTS 














BLUE] brown] green] YELLOW 








1st ref ( !n) 


obtains 


"BLUE" 


BROWN] GREEN] YELLOW 








2nd ref ( !n) 


obtains 


"BROWN" 


green] yellow 








3rd ref ( !n) 


obtains 


"GREEN" 


YELLOW 















Figure B. General Form for Select Register Reference 
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2 THE PROC PROCESSER 

2.5 BUFFER REFERENCING, DIRECT AND INDIRECT 



Direct and indirect reference may be made to input, output and file buffers, 
and to select registers. 



Four characters are reserved to indicate the buffer referenced: 

% - Reference the primary input buffer 

# - Reference the currently active output buffer (see ST command) 

& - Reference a file buffer 

! - Reference a select register. 

Direct referencing of the buffers is accomplished by following the appropriate 
buffer character with literal (s). See Figure B. 

An indirect reference can be made by following the buffer reference character(s) 
with the input or output buffer symbol and literal. The indirect reference may 
only be from the primary input buffer (%) or the current output buffer (#) . If 
the value referenced is non-numeric, then zero is used. See Figure C. 

Buffer references may be used with many PROC commands. For a detailed descrip- 
tion, see the descriptions of the individual commands. 

PROC commands which use buffer references are : 



F-OPEN 


NIP 


MV 


F-READ 


NIH 


F; 


F -WRITE 


T 


IF 


F-CLEAR 


L 




F-DELETE 


NH 








%n 


Obtain parameter "n" from primary input buffer. 


#n 


Obtain parameter "n" from " current" output buffer. 


SF.n 


Obtain attribute "n" from file buffer "F". 


!n 


Obtain the next value from select register 'n' . 



%23 
#4 

&4.19 
!3 



Figure A. Buffer Reference Syntax 



Obtain the 23rd parameter from the primary input buffer. 
Obtain the 4th parameter from the current output buffer. 
Obtain attribute 19 from file buffer 4. 
Obtain the next value from select register 3. 



Figure B. Direct Reference 



%%5 



-Obtain the actual parameter to be used from the value in 
parameter 5 of the primary input buffer 

-Obtain parameter from primary input buffer. ■ 



&3.#4 



^- — Obtain the actual attribute to be used from the value in the 4th 
parameter of the current output buffer. . 

-Obtain the attribute from the file buffer (&) number 3. 



Figure C. Indirect Reference 
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2 THE PROC PROCESSOR 

2.6 AN OVERVIEW OF PROC COMMANDS 




The first line (attribute) of a PROC must contain the code PQ. This identifies 
the item as a PROC. The remaining lines in the PROC may contain any valid PROC 
commands. There is no limit to the number of lines in a PROC. However, each 
line may contain only one command, and each command must begin in column posi- 
tion one of the line. If a comment appears on the second line, it will be 
printed by the LISTPROCS verb. 

Many different PROC commands are provided. Typical commands are listed in 
Figure A. A complete description of each command is presented in the remaining 
topics within this section. 

Any PROC command may optionally be preceded by a numeric label. Such a label 
serves to uniquely identify its associated PROC command for purposes of branch- 
ing or looping within the PROC. Labels may consist of any number of numeric 
characters (e.g., 5, 999, 72, etc.). When a label is used, the PROC command must 
begin exactly one blank beyond the label. For example: 

1 GO 5 
23 A 

99 IF A = ABC GO 3 

2 ST ON 

As an introductory example to PROC commands, consider the following PROC stored 
as item "DISPLAY' in the user's M/DICT: 

PQ 

HLIST ONLY 

A2 

P 

Assume that the user types in the following: 

: DISPLAY INVENTORY 



This input evokes the above PROC and places the words DISPLAY INVENTORY in the 
primary input buffer. The second line of the above PROC is an H command which 
causes the text LIST ONLY to be placed in the primary output buffer. The third 
line is an A command which picks up the second word (parameter) in the primary 
input buffer and places it in the primary output buffer. Thus the primary out- 
put buffer contains the words LIST ONLY INVENTORY. The last line of the PROC 
is a P command which submits the content of the primary output buffer to TCL 
for processing (i.e., LIST ONLY INVENTORY is an ENGLISH sentence which causes 
the item-ID 's of the INVENTORY file to be listed; refer to the ENGLISH Referenc-s 
Manual) . 



L 



CQMMMQ br]:ef descriptton 

^' NA Moves data from input to output buffers. 

B/ NB Baok up input pointer. 

BO, NBO Backup up output pointer. 

C Specifies comment. 

^ Outputs from either input buffer to terminal. 

^' NF Moves input pointer forward. 

F' Calculates a function. 

^' GO Unconditionally transfers control. 

GOSUB, RSUB Call local subroutine, return. 

^' NH Moves text string to either output buffer. 

^^ Conditionally executes specified command. 

^H' NIH Moves text string to either input buffer. 

^N Inputs from terminal to secondary input buffer. 

^P' NIP Inputs from terminal to either input buffer. 

^'^' NIT Inputs from tape to primary input buffer. 

Formats spooler output. 

O Outputs text string to terminal. 

P Causes execution of FROC. 

PP ^iQ-p^ays content of output buffers and executes FROC. 

RI Clears (resets) input buffer. 

RO Clears (resets) both output buffers. 

RTN Return from FROC subroutine. 

^' NS Fositions input pointer and optionally selects 

primary input buffer. 

ST ON Selects secondary output buffer (stack). 

ST OFF Selects primary output buffer. 

T Formats console output. 

TR Turyis FROC trace on. 

u Exits to user-defined subroutine . 

X Exits back to TCL level. 

+ Adds decimal number to parameter in input buffer. 

Subtracts decimal number from parameter in input 
buffer. 

( ) / [ ] Links to another FROC. 



Figure A. Summary of PROC Commands 
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THE PROC PROCESSOR 



2.7 SELECTING BUFFERS AND POSITIONING POINTERS: THE ST, S , NS , F , NF , B , NB , "^ 

BO, AND NBO COMMANDS | 



The STON and STOFF commands turn the stack on or off, respectively. The S com- 
mand positions the input pointer and/or selects the primary input buffer as the 
currently active input buffer. The F and B commands move the input pointer for- 
ward or backward one parameter, respectively. The BO command moves the output 
backward one parameter. 



I 



The STON command selects the secondary output buffer (the stack) as the currently 
active output buffer (i.e., turns the stack on). Its form is: 

STON or ST ON 

The STOFF command selects the primary output buffer as the currently active out- 
put buffer (i.e., turns the stack off). Its form is: 

STOFF or ST OFF 

When the stack is on, all data picked up by the A command is moved to the secon- 
dary output buffer. When the stack is off, these data are moved to the primary 
output buffer. The stack may be turned on or off at any point within the PROC. 
Upon initial entry to a PROC, the stack is off. 

The S command positions the input pointer and/or selects the primary input buffer 
as the currently active input buffer. This command may be used in either of the 
following two general forms: 

S(m) or NS(m) 
Sp or NSp 

The S(m) form selects the primary input buffer and moves the pointer to the m'th 
column, with columns numbered starting at 1. The Sp form moves the input pointer 
to the p'th parameter of the currently active input buffer. 

The F command causes the input pointer for the currently active input buffer to 
move forward one parameter. If the input buffer pointer is currently at the be- 
ginning of the buffer, this command has no effect. The form of the F 
command is as follows: 
F or NF 

The B command causes the input pointer for the currently active input buffer to 
move backward one parameter. If the input buffer pointer is currently at the 
beginning of the buffer, this command has no effect. The form of the B 
command is as follows: 

B or NB 

The BO command causes the output pointer for the current output buffer to move 
backward one parameter. If the output buffer pointer is currently at the be- 
ginning of the buffer, this command has no effect. Moving the pointer back | 
will cause data to be eliminated. The form of the BO command is as follows: | 

BO or NBO 
Figure A summarizes the above commands. Figure B presents some examples. 
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STON or ST 0N-<- 



turns secondary output buffer ( stack) on 



STOFF or ST OFF-«*- 
S(m) or NS(m) — ^ 



turns secondary output buffer (stack) off 



selects primary input buffer 
& moves pointer to m'th column 



SP or NSp 
F or NF 
B or NB 
BO or NBO 



moves input pointer to p'th parameter 



moves input pointer forward one parameter 



moves input pointer backward one parameter 



moves output pointer backward one parameter 



Figure A. General Form of ST, S, F, B, and BO Commands 





PRIMARY INPUT BUFFER BEFORE 




COMMAND* 

S(9) 

COMMAND** 

S3 

COMMAND** 

F 

COMMAND** 

B 

COMMAND*** 

BO 

EXECUTION : 


PRIMARY INPUT BUFFER AFTER 






ABC123 XYZ987 




ABC123 XYZ987 






SECONDARY INPUT BUFFER BEFO 


RE 


SECONDARY INPUT BUFFER AFTER 




ABC DE FGHIJ 




ABC DE FGHIJ 






SECONDARY INPUT BUFFER BEFO 


RE 
RE 

m 

z^ND 


SECONDARY INPUT BUFFER AFTER 




ABC 123 DEF 456 


ABC 123 DEF 456 






SECONDARY INPUT BUFFER BEFO 


SECONDARY INPUT BUFFER AFTER 




ABC 12 3 DEF 456 


ABC 12 3 DEF 456 






PRIMARY OUTPUT BUFFER COMMA 


PRIMARY OUTPUT BUFFER AFTER 




XXX YYY ZZZ 


XXX YYY ZZZ 






ACTIVE BUFFER PRIOR TO COMM. 


f 






*primary or secondary input 
**secondarY input buffer 
***primary output buffer 


buffer 





Figure B. Sample Usage of S, F, B, and BO Commands 
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2 THE PROC PROCESSOR 

2.8 MOVING PARAMETERS: THE A OR NA COMMAND 



The A command is used to retrieve a parameter from the input buffer and move 
it to the output buffer. Either the primary or secondary input buffer may 
be used as the source, and either the primary or secondary output buffer may 
be used as the destination; the buffers used depend on commands executed 
prior to the A command. The NA form of this command uses an attribute mark 
as the parameter separator; otherwise NA operates the same as A. 



The A command may be used in any of the following general forms : 

A{c}{p} NA{c}{p} 

A{c}{({m}{,n})} NA{c}{({m}{,n})} 

If the parenthetical specification (i.e., m and/or n) is not used, then the 
parameter is obtained from the currently active input buffer, at the current 
position of the input pointer. Leading blanks are deleted from the parameter. 
The end of the parameter is designated by the first blank which is encountered. 

If the parenthetical specification is used, then the parameter is always ob- 
tained from the primary input buffer. If the secondary input buffer is cur- 
rently active, use of this option causes a switch back to the primary input 
buffer. If both m and n are specified (i.e., in the A(m,n) form), the input 
buffer pointer is set to the m'th column, and the next n characters (including 
any embedded blanks) is the parameter to be moved. The m specification may be 
used by itself in the form A(m) . In this case the parameter is obtained from 
the m'th column and continues until the first delimiter after column m is encounter- 
ed. The n specification may also be used by itself in the form A( ,n) . In this 
case the next n characters are moved, starting at the current position of the input 
pointer. 

When the form Ap is used, the p'th parameter is moved, where parameters are 
separated by blanks, or attribute marks for NAp., 

When the form Ac is used (where c is any non-numeric character except a left- 
parenthesis character) and the primary output buffer is active (i..e., stack is 
off) , the character c surrounds the parameter. This feature is useful for picking 
up item-ID' s (which require single quotes) and values (which require double quotes) 
for processing by the ENGLISH language processor. If not specified, the A cominand 
uses a blank as the default surround character. 

Multiple parameters may be moved to the primary output buffer via a single A com- 
mand if these parameters are separated by semicolons in the input buffer. The 
parameters will be moved to the primary output buffer with the semicolons re- 
placed by blanks (or attribute marks) . After the execution of an A command, the 
input buffer pointer is pointing to the very next character after the move. 

Figure A summarizes the general form of the A comm.and. Figure B presents a num- 
ber of examples. Each example assumes that the output pointer is at the beginning 
of the buffer prior to the illustrated operation. 
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surrounds 
parame ter 



NA{c}{p} 
A{c}{p} 



PRIMARY INPUT BUFFER 



AB CD EF GHI JK 



f 



PRIMARY INPUT BUFFER 



AB CD EF GHI JK 



t 



PRIMARY INPUT BUFFER 



AAA BBB CCC 



t 



PRIMARY INPUT BUFFER 



ABC DEF GHIJK 



t 



SECONDARY INPUT BUFFER 



ABC; DEF; GHI JKL 



t 



SECONDARY INPUT BUFFER 



AAAA BB CCC D 



t 



parameter 
count 



A{c}{({m}{,n})} 
NA{c}{({m}{,n})} 



starting 
QO tumn 
posit-ion 



number of 
characters 



Figure A. General Form of A and NA Commands 



COMMAND * 
A 

COMMAND ** 
A(7,6) 

COMMAND * 
A(6) 

COMMAND * 
A' (,2) 

COMMAND *** 
A" 

COMMAND *** 
A2 



PRIMARY OUTPUT BUFFER 



CD 



t 



SECONDARY OUTPUT BUFFER 



EF GHI 



PRIMARY OUTPUT BUFFER 



BB 



t 



PRIMARY OUTPUT BUFFER 



DE 



PRIMARY OUTPUT BUFFER 



"ABC" "DEF" "GHI" 



t 



PRIMARY OUTPUT BUFFER 



BB 



ACTIVE BUFFERS PRIOR TO COMMAND EXECUTION : 

*primary or secondary input; primary output 
**primary or secondary input; secondary output 
***secondary input; primary output 



Figure B. Sample Usage of A Command 
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2 THE PROC PROCESSOR 

2.9 MOVING PARAMETERS: THE MV COMMAND 



iM. 



The MV command can be used to move data from any buffer or register to any 
buffer or register. 



The MV command always has two operands. The first is the object of the move or 
the receiving field. The second is the source or the sending field. The re- 
ceiving field may be any direct or indirect buffer reference. The sending field 
may be any direct or indirect buffer reference, or a single value, a string of 
values separated by commas, or a concatenation of values (see Figure A) . 

The simplest form is moving one value into the receiving field (Figure B) . 

A string of values may be moved into successive buffer locations by separating each 
value with a comma. If the sending field contains multiple contiguous commas, the 
effect is to not modify that number of buffer locations in the receiving field 
(Figure C) . If an asterisk is used to separate values, then concatenation occurs. 

An asterisk (*) as the last item in a string of values will move all remaining 
values in the sending field to successive receiving buffer locations. If the form 
n* is used, then n additional values will be moved. 

The MV command will construct the required number of null attributes if the re- 
ceiving field is beyond the current end of the buffer. 

NOTE: The MV command recognises an attribute mark as the separator for 

buffer parameters. I 



reoe-iving field 



MV OPERANDI . OPERAND 2 

1 f 



b lank 
separator 



sending field 



Figure A. General Form of the MV Command 



MV 


&3. 


1 &5.2 


Move value from file buffer 5y parameter 2 to 
file buffer 3^ parameter 1. 


MV 


%4 


"SMITH" 


Move the literal "SMITH'' to the 4th parameter 
of the primary input buffer. 


MV 


#1 


%5 


Move value from primary input buffer parameter 6 
to the 1st parameter of the current output buffer. 


MV 


!3 


&3.18 


Move attribute 18 of file buffer 3 into select 
register 3. 

BOTE: The single value move (MV) is the only 
valid form when a select register is 
specified in operand 1. 



Figure B. Simple Forms of MV Command 



MV &1.1 %3,%7 



MV &2.1 %3,%7,"SAM",#8 



MV %4 %2*%7 



MV &1 . &2 . , * 



MV &9 . 4 



Move the 3rd and 7th parameters from the primary 
input buffer into file buffer 1^ parameter 1 and 
parameter 2. (Consecutive receiving fields.) 

Move the 3rd and 7th parameters from the primary 
input buffer^ the literal "SAM" and the 8th par- 
ameter of the current output buffer into file 
buffer 2^ parameters 1,2^3^ and 4 respectively. 

Concatenate (=^) the 2nd and 7th parameters of the 
primary input buffer and move into parameter 4 of 
the primary input buffer (%) . 

Move from file buffer 2 all parameters C^) into 
file buffer 1 starting in parameter 0. 

Move the literal "X" into file buffer 9^ parameter 
4. Skip (don't modify) parameters 5^6,7 then move 
literal "Y" into parameter 8. 



Figure C. Complex Forms of the MV Command 
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2 THE PROC PROCESSOR 

2 . 1.0 MOVING PARAMETERS : THE MVA AND MVD COMMANDS 



The MVA and MVD commands add and delete values in multi-valued attributes 
within the file buffers. 



The MVA and MVD commands always contain two operands separated by a blank (see 
Figure A) . Operand one must be a file buffer reference. Operand two may be any 
single value (i.e., a direct or indirect reference or a literal). 

The MVA command moves the value from the sending field into the receiving field 
and stores it as a multi-value. The new value is stored in ascending ASCII se- 
quence. If the value already exists, it will not be duplicated. If the sending 
field is itself multi-valued, it is stored as one multi-valued set and may, there- 
fore, create duplicate values and destroy the ascending sequence of the attribute. 

The MVD command deletes the value specified in the sending field from the values 
in the receiving field. If the receiving field is not in ascending ASCII sequence, 
the MVD command will not function properly. 

NOTE: The MVA and MVD commands use an attribute mark as the parameter separator. 



MVA OPERANDI OPE RAND 2 
MVD OPERANDI 0PERAND2 



veoe-iv'lng f-ietd 



IpiA — I I — 



sending field 



Figure A. General Format of the MVA and MVD Commands 



BEFORE : 


&1.0 


[ABCf DEF] GHlf JKLf FORf^ 




COMMAND : 


MVA &1.,1 &1.3 






AFTER: 


&1.0 


[ABCf DEF] for] GHlf JKLf FORf^ 




BEFORE : 


&1.0 


[ABC DEF] GHliJKLf MNO^^ 






&3.0 


[AAA BBB EXTRA] MONEY] WAGEfENDf^ 




COMMAND : 


MVA &1.1 &3.2 






AFTER: 


&1.0 


[ABCf DEF] EXTRA] MONEY] WAGE] GHlf JKLf MNO<- 




BEFORE : 


&2.0 


[ABCf DEF] GHI] JKLf MNOf^ 




COMMAND : 


MVD &2.1 GHI 






AFTER: 


&2.0 


[ABCiDEF] JKLf MNOi^ 





Figure B. Examples of MVA and MVD Commands 
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2.11 INPUTTING DATA: THE IN, IP, IT, NIN , NIP AND NIT COMMANDS 



The IN command selects the secondary input buffer and accepts input from the 
terminal. The IP command accepts input from the terminal to the currently- 
active input buffer. The IT command accepts input from magnetic tape to the 
primary input buffer. The commands NIN, NIP and NIT use attribute marks as 
parameter delimiters but otherwise function identically to their counterparts. 



The IN command selects the secondary input buffer as the currently active input 
buffer land inputs data from the terminal into the buffer (the original contents 
are lost) . The general form of this command is : 

IN{r} or NIN{r} 

If the r specification is used, then that character is a prompt character at the 
terminal (r may be any character including a blank) . The prompt character will 
remain in effect until a new IN command with a new r specification is executed. 
If r is omitted, then a colon (:) is used as a prompt. Data input by the user is 
placed into the secondary input buffer and may be moved to an output buffer by 
using the A command. However, when the primary input buffer is selected via the 
"A" command, or if the S (m) command is used, then the data in the secondary input 
buffer is lost. 



I 



The IP command inputs data from the terminal into the currently active input buf- 
fer. The general form of this command is: 

lP{B}{r} or NIP{r} 

Data input at the terminal in response to an IP command replaces the current 
parameter (i.e., as pointed to by the input pointer) of the currently active in- 
put buffer. If several parameters are input at the terminal, then they will all 
replace the current parameter in the buffer. If the input pointer is at the end 
of the data in the input buffer, then the new input data will be appended to the 
end. The r specification is identical to the r specification for the IN command 
(see above) . If B is used in the command (i.e., IPB or IPBr) , then all embedded 
blanks in the data input at the terminal will be replaced by backslash characters 
(\) . This feature is useful if a parameter is to include embedded blanks (i.e., 
since blanks denote the end of a parameter) . 

The IT command reads one record (maximum size 300 characters) from the magnetic 
tape unit. The data are placed in the primary input buffer. (The original con- 
tent of the primary input buffer is lost.) The general form of the IT command is; 

IT{c}{a} or NIT{c}{a} 

If the C option is used, an EBCDIC to ASCII conversion is performed on the record, 
If the A option is used, the 8-bit ASCII characters are masked to 7-bits (i.e., 
MSB=0) . A null or all-blank record constitutes an end-of-file condition. (For 
further information regarding magnetic tape operations, refer to the Reality Pro- 
gramm.er ' s Reference Manual . ) 
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The general forms of the above commands are summarized in Figure A. 
sents a number of examples. 



Figure B pre- 





















input opevation from 
terminal to secondary 
input buffer 
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input operation from 
terminal to active 
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1 


prompt 
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NIP{B}{r} 
IPiB}{r} 






input operation from 
tape to primary 
input buffer 




T 


replaces blanks 
by backslashes (\) 






KT XT' -rr"]- -T al- 










it{c}{a} 




EBCDIC to ASCII conversion 


masks 8th bit 

















Figure A. General Form of IN, IP, and IT Commands 



COMMAND 


EXPLANATION 


IN 


Selects secondary input buffer and in- 
puts data from terminal. Prompt charac- 
ter is a colon ( : ) . 


IN= 


Selects secondary input buffer and 
inputs data from terminal. Prompt 
character is an equal sign (=) . 


IP? 


Replaces current parameter in currently 
active input buffer with data from 
terminal. Prompt character is a 
question mark (?) . 


IPB? 


Same as above ^ but embedded blanks in 
input data are replaced by backslash 
characters (\) . 


ITCA 


Inputs tape record to primary input 
buffer. EBCDIC to ASCII conversion is 
performed^, with 8-bit ASCII masked 
to 7 -bits. 



Figure B. Sample Usage of IN, IP, and IT Commands 
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2 THE PROC PROCESSOR 

2.12 OUTPUTTING DATA: THE O AND D COMMANDS 



The O command is used to output a specified text string to the terminal, 
The D command is used to output parameters from either input buffer to 
the terminal . 



The O command has the following general form: 

0{text}{+} 

The O command causes the text which immediately follows the O to be output 
to the terminal. If the last character of the text is a plus sign (+) , 
then a carriage return will not be executed at the end of the text output. 
This feature is useful when using the O command in conjunction with the IN 
command. For example, consider the following commands: 

OPART-NUMBER+ 
IN= 

These commands produce the following output on the terminal: 

PART-NUMBER= 

The specified prompt character (=) is displayed adjacent to the output text 
since the O command ended with a plus sign (+) . The user then enters the 
input data right after the prompt character. For example: 

PART-NUMBER=115a20 

Figure B illustrates further examples of the O command. 

The D command is used to output parameters from either input buffer to the 
terminal. The D command may be used in either of the following general forms: 

D{p}{+} 

D(m){+} D(m,n){+} 

If the form Dp is used, then the p'th parameter of the currently active input 
buffer is displayed on the terminal. If the form D is used, then the current 
parameter (i.e., as pointed to by the input pointer) of the currently active 
input buffer is displayed on the terminal. If the form I^ is used [i.e., p = 
(zero)], the complete currently active input buffer is displayed on the terminal. 
If the form D(m,n) is used, then the characters starting at the m'th column for 
n characters (including separators) are displayed. If the form D(m) is used, 
then the characters starting at the m'th column (blanks are included in the 
column count) of the primary buffer (up to the first blank character encountered) 
are displayed. 

A plus sign (+) may be appended to the end of the D command, thus specifying 
the suppression of a carriage return (as for the command described above.) 
The D command does not affect the input pointer. 

Figure C illustrates the use of the D command. 



text jg output to tevm-indl 



0{text}{+} 



D{p}{+} 



p't/z OT QUTvent (if p omitted) 

parameter of active input buffer 

is output to terminal 






suppresses carriage return 



suppresses carriage return 



D(m,n) {+} 

A 

D(m) 



parameter starting at m'th 
cohmn of primary input 
buffer is output to terminal 



{+} 

L 



suppresses carr%age return 



number of characters 



Figure A. General Form of O and D Commands 



COMMAND 

OTHIS IS AN EXAMPLE 

OTHIS IS AN EXAMPLE+ 



OUTPUT TO TERMINAL 
THIS IS AN EXAMPLE 

THIS IS AN EXAMPLE 



Figure B. Sample Usage of O Command (- = The Cursor) 
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SECONDARY INPUT BU 
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PRIMARY INPUT BUFF 






ABC XYZ 123 





COMMAND* 



COMMAND** 



D4+ 



OUTPUT TO TERMINAL 

BBB 

OUTPUT TO TERMINAL 

DDD 



COMMAND*** OUTPUT TO TERMINAL 



\ 



D(6) 



YZ 



ACTIVE BUFFER PRIOR TO COMMAND EXECUTION : 
*primary input buffer 
**secondary input buffer 
***primarY or secondary input buffer 



Figure C. Sample Usage of D Command 
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2.13 TEXT STRINGS AND CLEARING BUFFERS: THE IH ,NIH ,H ,NH , RI AND RO COMMANDS 



The IH or NIH and H or NH commands are used to place a specified text string in 
the currently active input or output buffer, respectively. The RI and RO com- 
mands are used to reset the input and output buffers (respectively) to the empty 
(null) condition. 



The IH (input Hollerith) command causes the text (including any blanks) immediately 
following the IH to replace the current parameter (as specified by the input 
pointer) in the active input buffer. The input buffer pointer will remain pointing 
to the beginning of this string. 

The NIH command will input a string into the primary input buffer at the location 
specified by the current position of the input buffer pointer. The string will 
replace the attribute immediately following the pointer. A space appearing within 
the string being input will be converted to an attribute mark. Use of the NIH 
command with only a backslash following (as NIH\) will be used to null an attri- 
bute, and all appearances of a space-backslash-space sequence within the string 
will establish a null attribute. Certain special characters may not appear in an 
NIH literal string. These are the value mark (m[cs]) and the sub-value mark 
(l[cs]). If any invalid characters do appear, the resultant values loaded into 
the buffer will be unpredictable. 

The H command causes the text (including blanks) which follows the H to be placed 
in the active output buffer at the position of the output pointer. When the last 
parameter has been moved to the secondary output buffer (the stack) , a carriage 
return specification (<) must be placed in the stack. Two less than signs («) 
appearing as the last two characters in an H command will be recognized as a con- 
tinuation character and a carriage return. This is useful for stacked information 
containing more than 140 characters. 

The NH command uses an attribute mark as the parameter delimiter instead of a 
blank as in the H command and is otherwise similar. 

The RI (Reset Input Buffers) command has three forms. If the form RI is used, then 
both input buffers are reset to the empty (null) condition. If the form Rip is 
used, the primary input buffer from the p'th parameter to the end of the buffer 
(as well as the entire secondary input buffer) is reset to the empty condition. 
If the form RI (m) is used, then the primary input buffer from the m'th column to 
the end of the buffer (as well as the entire secondary input buffer) is reset to 
the: empty condition. The input buffer pointer remains at the end of the buffer. 

The RO (Reset Output Buffers) command resets both output buffers to the empty (null) 
condition. The RO command also selects the primary output buffers as though an 
STOFF command had been executed. 
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IH{text} or NIH{text} 



1 



text replaces cuvvent pavametev 
of active input buffer 



text is placed in 
active output buffer 



H{text}{<} or NH{text}{<} 



carriage return 
specification 



Rl{p} 



primary input buffer (from p'th 
parameter and on, if p is used) and 
secondary input buffer are reset 



RI (m; 



primary input buffer (from m'th 
column and on) and secondary input 
buffer are reset 



RO-*- 



both o utput buffers a re reset 



Figure A. General Form of IH, H, RI , and RO Conunands 
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**£5econdary output buffer 







Figure B. Sample Usage of IH, H, and RI Commands 
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2.14 TRANSFERRING CONTROL: THE GO, GO F,GO B,M,GOSUB AND RSUB COMMANDS 



The GO commands provide unconditional branching within PROC's. 



The GO command causes control to unconditionally transfer to the PROC command which 
has the numeric label n. For example: 

G 10 or GO l(2r 

This command causes control to transfer to the PROC command which begins with the 
label 10. The user should note that several PROC commands may begin with the 
same label. If this is the case, the GO command transfers control to the first 
PROC command which begins with the specified label (scanning from the top) . This 
is generally the slowest form of the branching instructions. 

The GO F and GO B commands go forward and backward (respectively) to the appropri- 
ate M (mark) command. The GO B command will branch to the instruction following 
the last executed M (mark) command. The GO F command scans forward until it can 
execute an M command and then continues processing of the command following the 
M command. 

The M (mark) command simply causes the PROC processor to remember or "mark" its 
location. Only the last executed M command is remembered. 

Note that GO F, GO B, and M are not necessary if the PROC is to be compiled (see 
PQ-COMPILE verb) . 

A GOSUB command causes execution control to be transferred to the specified label. 
See Figure A for a summary of the instructions. An RSUB n command returns execu- 
tion control n lines after the GOSUB. If n is missing, then n=l is assumed. An 
RSUB command will be ignored if no previous GOSUB was executed. 
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GO n 


Go to label n. 


GOSUB n 


Go to subroutine at label n. 


RSUB n 


Return to subroutine call. Begin executing 
n lines after the call. If n is missing^ 
then n=l. 


GO B 


Go back to previous mark command. 


GO F 


Go forward to next mark command. 


M 


Mark command. 



Figu2:e A. General Command Formats 



This 


PROC will print 


the numbers 1 through 5 on the terminal. 


001 


PQ 




PROC identification. 


J 002 


GOSUB 200 




Branch to subroutine 200. 


003 


M 




"Mark" location. 


004 


IF # A GO F 




Test for null parameter; if missing^ go 
forward to next "Mark". 


005 


D+ 




Output current parameter. 


006 


F 




Move buffer pointer forward. 


007 


GO B 




Go back to previous "Mark". 


008 


M 




"Mark". 


009 


X FINI! ! 




Exit PROC and print FINI! ! 


010 


200 IH 1 2 3 


4 5 


Subroutine 200^ insert numbers into buffer. 


Oil 


RSUB 




Return to subroutine call (Line 200). 



Figure B. Example of Transferring Control 
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2.15 TRANSFERRING CONTROL: THE SIMPLE IF COMMAND 



The IF command transfers control to another statement within the PROC, 



The IF command provides for the conditional execution of a specified PROC command. 
The IF command takes on three general forms. The simple form is as follows: 

IF {#}a-cmnd proc-cmnd 

where a-cmnd is any legal form of the A command (refer to the topic titled MOVING 
PARAMETERS : THE A AND NA COMMAND) except for the form using the character surround 
feature (i.e., Ac), and where proc-cmnd is any legal PROC command. If the optional 
# is not used, the IF command simply tests for the existence of a parameter in the 
input buffer as specified by the A command. If a parameter exists, the specified 
PROC command is executed; otherwise, control passes to the next sequential PROC 
command. For example: 

: IF NA2 GO 15 

This command tests for the existence of a second parameter in the currently active 
input buffer. If a parameter exists, control passes to the PROC command beginning 
with label 15; otherwise, control passes to the next sequential PROC command. If 
the # option is used, the test is reversed. For example: 

IF # A2 GO 15 

This command causes control to transfer to the command with label 15 if a second 
parameter does not exist. 

The user should note that when using an A command as a test condition of an If com- 
mand, parameters are not moved to an output buffer as would be the case if the A 
command were used along. Rather, the A command is used simply to specify which 
parameter in the input buffer is to be tested. However, the input pointer wltZ 
be re-positioned as specified by the A comm.and. 

A number of examples illustrating the simple form of the IF command are presented 
in Figure B. For a discussion of the two other forms of the IF command, refer to 
the topic titled RELATIONAL TESTING: THE RELATIONAL IF COMMAND and topic titled 
PATTERN TESTING: THE PATTERN MATCHING IF COMMAND. 



I 



I 



any legal A command form except 
character surround (Ac. or NAC) 



T 



IF {#}a-cmnd proc7cmnd 

i_ 1 



reverses test \ \ any legal PROC command \ 



Figure A. Simple Foirm of IF Command 



NOTE: The following examples assume that the primary input buffer 
'is the currently active input buffer and contains the 
following parameters: 



ABC AAA XYZ 



f 



COMMAND 
IF A GO 2 7 
IF A3 OHELLO 

IF A4 OHELLO 



EXPLANATION 

Control is transferred to the command with label 27. 

Message HELLO is output to terminal; control then 
continues with next sequential command. 

Message is not output; control continues with next 
sequential command. 



IF A (11) GO 2 Control is transferred to the command with label 2. 



Figure B. Sample Usage of Simple IF Command 
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2.16 RELATIONAL TESTING: THE RELATIONAL IF COMMAND 



The relational form of the IF command allows parameters in the input 
buffers to be tested relationally. 



The relational form of the IF command is an extended version of the simple 
IF form (see topic titled TRANSFERRING CONTROL: THE GO AND SIMPLE IF 
COMMANDS). The relational form is as follows: 

If a-cmnd op string proc-cmnd 

where a-cmnd and proc-cmnd are as defined for the simple IF form, where op 
is one of the relational operators listed in Figure B, and where string is 
a literal string of characters which the parameter is to be compared 
against. For example: 

IF A = YES GO 5 

Here the PROC would transfer control to the command with label 5 if the 
current parameter in the currently active input buffer is the character 
string YES. 

To resolve a relational condition, character pairs (one from the selected 
parameter and one from the literal string) are compared one at a time from 
leftmost characters to rightmost. If no unequal character pairs are found, 
the strings are considered to be equal. If an unequal pair of characters 
are found, the characters are ranked according to their numeric ASCII 
code equivalents (refer to the LIST OF ASCII CODES in the Appendix B 
to this manual) . The character string contributing the higher numeric 
ASCII code equivalent is considered to be greater than the other string. 
For example, AAB is considered greater than AAAA, and 02 is considered 
greater than 005. 

If the selected parameter and the literal string are not the same length, 
but the shorter of the two is otherwise identical to the beginning of the 
longer one, then the longer string is considered greater than the shorter 
string. For example, the string WXYZ is considered to be greater than the 
string WXY. 

Further examples illustrating the relational IF command are presented in 
Figure C. 



any legal A command form except 
ohavaotev surround (Ac or BAo) 



any legal 
PROC command 



IF a-cmnd op string proc-cmnd 



relati onal operator \ H literal string 



tr 



Figure A. Relational Form of IF Command 



OPERATOR SYMBOL 


OPERATION 


= 


test for equal 


# 


test for not equal 


< 


test if -parameter less than literal string 


> 


test if -parameter greater than literal string 


- 


test if parameter less than or equal to 
literal string 


] 


test if parameter is greater than or equal 
to literal string 



Figure B. Relational Operators 



BOTE: The follo-iding examples assume that the primary input buffer 
is the currently active input buffer and contains the fol- 
loiDing parameters : 



I AB C AAA. XYZ 



COMMAND 



IF A = ABC GO 3 



IF A3 > XYX HTEST 



IF A2 > XYX HTEST 



EXPLANATION 

Control is -transferred to the command -with 
labe 1 3 

The text string TEST is placed in the cur- 
rently active output buffer; control then 
continues -with next sequential command. 

Text string TEST in not placed in output 
buffer; control continues with next sequential 
command. 



IF A (2, 2) = BC GO 7 Control is transferred to the command with 

label 7. 



Figure C. Sample Usage of Relational IF Command 
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2.17 PATTERN TESTING: THE PATTERN MATCHING IF COMMAND 



The pattern matching form of the IF command allows parameters in the 
input buffers to be tested for a specific pattern match. 



The pattern matching form of the IF command is an extended version of the 
simple IF form (see topic titled TRANSFERRING CONTROL: THE GO AND SIMPLE 
IF COMMANDS). The pattern matching form is as follows: 

IF a-cmnd op (pattern) proc-cmnd 

where a-cmnd and proc-cmnd are as defined for the simple IF form, where op 
is one of the relational operators described for the relational IF form, 
and where pattern is a pre-defined format string enclosed in parentheses. 

A pattern is used to test a parameter for a specified combination of numeric 
characters, alpha characters, alpha-numeric characters, or literals. The 
pattern specification in an IF statement consists of any combination of the 
following: 

• An integer number followed by the letter N (which tests for 
that number of numeric characters) . 

• An integer number followed by the letter A (which tests for 
that number of alpha characters) . 

• An integer number followed by the letter X (which tests for 
that number of alpha-numeric characters) . 

• A literal string (which tests for that literal string of 
characters) . 

As an example, consider the following command: 

If A = (3NABC) G 3 

This command causes a transfer of control to the command with label 3 when 
the current parameter of the currently active input buffer consists of 
three numerals followed by the characters ABC (e.g., 123ABC) . 

If the integer niraiber used in the pattern is 0, the test is true only 
if all the characters in the parameter conform to character type. The 
following command, for example, outputs the message OK if the characters 
of the current parameter are all alpha characters: 

IF A = (OA) OOK 

Further examples of the pattern matching form of the IF command are 
illustrated in Figure B. 

The user should note that for any of the three IF command forms, the 
PROC statement which is conditionally executed may in turn be another 
IF command (i.e., IF commands may be nested). The following command, 
for example, transfers control to label 99 if the current parameter 
consists of two numerals in the range 10 through 19 (inclusive) : 

IF A = (2N) IF A H 10 IF A C 19 GO 99 



The user may wish to visualize nested IF commands as though implied AND 
operators were placed between them. 



any label A command form 
except oharaoter surround (Ao) 



i 



any legal 
PROC command 



I 



IF a-cmnd op (pattern) proc-cmd 



relational operator 



^ H 



pattern match 
specification 



Figure A. Pattern Matching Form of IF Command 



I^OTE: The following examples assume that the primary input 

buffer is the currently active input buffer and contains 
the following parameters . 



ABC 10/09/75 XYZ B123C 33 



COMMAND 



IF A = (3A) G 7 

IF A2 = (2N/2N/2N) G 5 

IF A4 = (ON) G 9 
IF A5 = (ON) GO 2 

IF A4 = (1A3NC) OGOOD 

IF Al = (3X) IF Al > ABB G 9 
IF A(5,2) = (2N) G3 



EXPLANATION 

Control is transferred to the com- 
mand with label 7. 

Control is transferred to the com- 
mand with label 6. 

Control continues with next se- 
quential command. 

Control is transferred to the 
command with label 2. 

The message GOOD is output to 
the terminal i control continues 
with the next sequential command. 

Control is transferred to the 
command with label 9. 

Control is transferred to the 
command with label 2. 



Figure B. Sample Usage of Pattern Matching IF Command 
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2.18 : COMPUTED BRANCHING: THE MULTI-VALUED IF COMMAND 



The ilF command can contain a multi-valued object and/or a multi-valued 
destination . 



When iusing the IF command with the equal (=) or not equal (#) operator, the object 
and/or the destination may be multi-valued. 

When using the equal operator, the multi-values are "OR'ed" together. This means 
that each multi-value will be tested against the argument; if any value is true, 
the branch is taken. 

When using the not equal operator, the multi-values are "AND'ed" together. All 
valudis must match the argument for the branch to be taken. 

If tlje object is multi-valued, then the destination may be a multi-valued GO or 
GOSUB command. This means that the destination labels may be multi-valued (sepa- 
rated by VM's). This is equivalent to an N-way branch. If there are more object 
values than destination values, the last destination will be executed for object 
values greater than the number of destinations. 






I 



IF A = OBJECT DESTINATION 
OR 

# 



Argument- 






Mult'l-valued 



Figure A. General Command Format 



If 


A2 


= 1]2]3 GO 200 


If A 2 equals a 1 or 2 or 3^ then go 
to label 200. 


If 


A4 


# RED] WHITE] BLUE GO 500 


If A4 is not equal to RED and not 
equal to WHITE and not equal to BLUE, 
then go to label 500. 


If 


A3 


= 1]2]3 GOSUB 10] 20] 30 


If AZ equals 1, then GOSUB label 10. 
If AZ equals 2, then GOSUB 20. If 
A3 equals 30, then GOSUB 30. 


If 


A5 


= 11] 12] 13 GO 10] 20 


If A5 equals 11, then GO TO 10. If A5 
equals 12 or 13, then GO TO 20. 



Figure B. Example Usage of the Multi-valued IF Command 
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2.19 FILE COMMANDS: THE F-OPEN AND F-CLEAR COMMANDS 



Files may be manipulated with the use of the PROC file commands. Up to nine 
files may be opened with the F-OPEN command. F-CLEAR clears the file buffer. 



File manipulation is performed by the various file commands available from PROC. 
Before the files can be worked on, they must be opened. 

The F-OPEN command (see Figure A) opens file Y and assigns it to file buffer num- 
ber X. X may be any digit 1 through 9. Y may be a literal file name or may be 
an indirect reference to a file name. The dictionary of a file may be opened by 
preceding the file parameter (Y) with the word DICT. 

A file need only be opened once. Files remain open throughout the PROC execution, 
including subroutine calls and PROC-to-PROC linkage. All files are closed upon 
termination of the PROC. File buffer numbers can be re-used by executing another 
F-OPEN command. The F-OPEN effectively closes the file previously opened to that 
buffer number and assigns the buffer to the newly opened file. See examples in 
Figure B . 

The F-CLEAR command clears the file buffer number Y (see Figure A) . An F-CLEAR is 
required if new records are being built, or if the file buffer is being used as a 
scratch area. It must be used before the first OPEN, READ, WRITE, or DELETE. 

NOTE: The file commands use an attribute mark as the parameter delimiter. 



I 

I 



F-OPEN X {dict}y-« File name 

I . 

F-CLEAR X •— — ' Opt^on to open the dictionary 

F^Ze buffer number 



Figure A. General Commarid Format 



F-OPEN 5 INVENTORY Opens the mVEBTORl file to file 

buffer 6 



F-CLEAR 3 Clear file buffer number 3 



Figure B. Examples of Opening Files and Clearing 
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2.20: FILE COMMANDS: THE F-READ, F-WRITE , AND F-DELETE COMMANDS 



The F--READ command loads an item into a file buffer. F-WRITE writes the con- 
tents of a file buffer. F-DELETE deletes from the file the item specified in 
the file buffer. 



The F-READ command reads an item into a file buffer. The item is read from the 
file which was previously opened to the file buffer number specified. The item-ID 
may be a literal or an indirect reference to an item-ID. 

If the item is found by the F-READ command, it is read into the file buffer and the 
PROC continues execution on the second line following the F-READ command (normal 
return) . If the item is not found, the PROC executes the statement immediately 
following the F-READ command (error return). See Figure B. F-READ does not lock 
the group of the file containing the item. 

The F-WRITE command writes the data contained in the file buffer number specified 
to the file currently opened to that file buffer. The item-ID for the item is ob- 
tained from the file buffer, attribute zero. No error condition exists for a write 

The F-DELETE deletes the item whose item-ID is found in attribute zero in the file 
buffer number specified. The item is deleted from the file currently opened to 
the file buffer. No error condition exists for a DELETE. 

NOTE: These aormands utilize an attribute mark as the separator parameter. 



F-READ X Y 
F -WRITE X 
F- DELETE X 



Item-ID (literal or indirect reference) 
File buffer number 



Figure A. General Command Format 



F-READ 1 1234 
GO 140 
GO 200 



F-READ 3 %4 



X READ ERROR 
GO 500 

F -WRITE 4 



F-DELETE 7 



Read item from the file opened to file 
buffer 1 into file buffer 1 using item-ID 
^1224', If founds execute second command 
(GO 200) ; if not founds execute first 
command (GO 140) . 

Read from file buffer 3 using the value in 
the 4th parameter in the primary input 
buffer. 

Error return after read 
Normal return after read 

Write the contents of file buffer 4 to the 
file currently opened to file buffer 4. 

Delete the item^ whose item-ID is contained 
as attribute zero in file buffer 7^ from 
the file currently opened to file buffer 
number 7. 



Figure B. Examples of File Commands 
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2.21 FILE COMMANDS: THE FB COMMAND 



The FB command combines an OPEN and a READ to load data into a "fast buffer". 



The FB command reads an item into an internal buffer from the file specified. 
There is only one "fast buffer", so subsequent uses of the FB command destroy 
previous data in the fast buffer. The FB command is preferable to an F-OPEN 
and F- READ sequence if only one item from a file is to be processed. The fast 
buffer is destroyed by a P command. 

The FB command, like the F-READ, has two return points. The normal return (suc- 
cessful read) is the second command following the FB command. The error return 
(unsuccessful read) is the command immediately following the FB command. 

Once the item is read into the fast buffer, it can be referenced using the &X 
form of indirect reference. Note that the command is ampersand (&) X (attribute 
number) . 

If the item-ID is omitted from the FB command, then the value in the current loca- 
tion of the primary input buffer is used as the item-ID. 

NOTE: The FB command uses an attribute mark as the parameter delimiter. 



\Mt,; 






FB ({dict} file -name Htem-ID}) 

ERROR RETURN 
NORiyiAL RETURN 



Figure A. General Form of the FB Command 



FB ( INVENTORY 


AB- 


-4158) 


Read into the fast buffer the item whose 


ERROR RETURN 
NORMAL RETURN 








Id is AB-4268 from the inventory file. 


FB (DICT INVENTORY 
ERROR RETURN 
NORMAL RETURN 


DL/ID) 


Read the DL/ID from the dictionary of the 
inventory file into the fast buffer. 


FB (INVENTORY) 
ERROR RETURN 








Read from the inventory file the item 
whose ID is contained at the current 


NORMAL RETURN 








pointer -position in the -primary input 
buffer. 



Figure B. Using the FB Command 
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2.22 FILE-LOCKS: THE F-UREAD, FBU, AND F-FREE COMMANDS 



The Read for Update commands lock out file items against other users . They 
use the Reality group lock facility. 



The F-UREAD and FBU commands function identically to the F-READ and FB commands 
except that they lock the group of the referenced file to which the item-ID hashes 
This serves to protect against simultaneous item retrieval by one line and item 
update by another. It also gives a logical lock capability. 

The group will be locked by the F-UREAD and FBU even if the item is not found. 

The F-FREE command will free all groups locked by the process. The form F-FREE 
X Y will unlock the group in the file X to which the item Y hashes. It will be 
unlocked only if the process has it locked. 



FBU ({dict} Hle-name {Item-ID}) 

F-UREAD X Y 



F-FREE {x y} 



-I tern- W 



File buffer 
nvxrhev 



Figure A. General Form of the File-Lock 



Commands 



F-UREAD 1 1234 



F-FREE 1 1234 



F-FREE 



Looks the group in the file opened to file buffer 

^•'^ Mo?^^ ^^^ -'^'''^^ ^^ ^^^'^^ '^^^^' hashes, even 
^T 1^34 ^s not on file, then proceeds as 'F-READ 

-L -L 00~l: , 

Unlocks the group locked in the above example, but 
only ^/ locked by this line. 

Unlocks all group locks locked by this line. 



Figure B. Examples 
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2.23 MATHEMATICAL FUNCTIONS: THE F; COMMAND 



The 



3 F; command provides the PROC processor with arithmetic functions, 



n 



The P; conrniand performs all functions in fixed point, integer arrttaetro This 
oonunaAd operates like the function correlative in dictionaxres. Elements in an 
p. command are separated by semi-colons (,) . An element may be an operand or an 
Le'rat^r. The ooLand is processed from left to right. Each element encountered 
is placed on the top of a push-down/pop-up stack. Each operator performs its 
function on the top of two entries in the stack, deletes them and places the result 
on the top of the stack. 
The result of the function can be moved into any of the PROC buffers. 



The 



stack concept can be visualized as follows 



STACK 1 
STACK 2 
STACK 3 
STACK 4 
STACK 5 



F ; elementl ; element2 ; . . . ; element n 



Figure A. General Format of the F; Command 



OPERANDS 

#n,%n,&n,&F.n 

Cn 
OPERATORS 
+ 

* 

/ 
R 

-f- 

?P 
?D 



SMITH'^400'^''8'^ 



Indirect vefevenoes to numevic values to he 
placed on the top of the stack. 

Constant "n" to be placed on the stack. 



Add top two entries in the stack. 

Subtract STACK2 from STACKl. 

Multiply top two entries in the stack. 

Divide STACKl by STACK2. 

Divide STACKl by STACK2, but return remainder to STACKl ^ 

Exchange STACKl and STACK2. 

Store STACKl at current primary input buffer pointer 
location. 

Store STACKl at buffer location specified by D. D is 
an indirect buffer reference. 



Figure B. F; Command Elements 



F;C20;%4;*;?p F; command 

Primary input buffer (pointer at parameter 3) 



El E2 E3 E4 
STACKl 20 8 160 160 
STACK2 - 20 - 



r^ A r\r\^i /- r\'^r^^ 



SMITH 400 160 8 Primary input buffer after execution of the F; command 



Figure C. Sample of F; Command Usage 
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2.24 FORMATTED LINE PRINTER OUTPUT: THE L COMMAND 



The L command causes the PROC processor to enter a line printer formatting 
routine . 



The L command is followed by one blank and any number of elements separated with 
commas. Each L command formats a line of output. If more elements are required 
than will fit on one PROC line, then the L command line should be terminated with 
a comma. Figure A shows the general format. 

Page headings are generated through the use of the HDR element. Any element may 
be used in a line containing a HDR; however, the elements shown m Figure B fol- 
lowing "HDR" may be used only following the HDR element. The E and n elements 
cannot be used in a HDR line. 

When a "HDR" line is encountered, any direct or indirect references are resolved 
and stored in a heading buffer. Therefore, it is not necessary to maintain the 
indirect reference values. After the first execution of a HDR line, the PROC will 
maintain a line counter and print a heading each time the counter exceeds the page 
depth set by the last TERM command. 



L elementl, element2 ,...,... ,element n, 

causes Qontinuation 



Figure A. General Form of L Command 



"text" 


Output any text between the quotes. 


(n) 


Set to Qolumn position n. 


%,#,& 


All forms of indiveot vefevenoing. 


E 


Eject to top of form. 


n 


Skip n lines before printing. 


C 


Close the print file. 


HDR 


Generates the page heading line. 


P 


Print current page number. 


T 


Print current time and date. 


Z 


Zero the page counter. 



Figure B. L Command Elements 



001 


PQ 




















002 


NIP 




















003 


L HDR,T, (40) 


/'PAGE", 


P 














004 


L 1, 


(10) ,%1, 


(15) ,%2, 


(20), 


%3,(25) 


/"PARAMETERS 


1 


THRU 


3" 


005 


L 1, 


(10) ,%4, 


(15) ,%5, 


(20) , 


%6, (25) 


, "PARAMETERS 


4 


THRU 


6" 


IF INPUT: 


100 200 300 400 500 


600 


::r 












will print: 


















10:09:25 


1 SEPT 1979 




PAGE 1 














100 


200 300 


PARAMETERS 


1 THRU 


3 












400 


500 600 


PARAMETERS 


4 THRU 


6 









Figure C. Sample PROC and Output 
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2.25 TERMINAL FORMATTING: THE T COMMAND 



The T command causes the PROC command to enter a terminal formatting routine. 



The T command is followed by one blank and any number of elements which are sepa- 
rated by commas (Figure A) . If a T command line ends with a comma, then the com- 
mand is continued on the next line. 

If the last element of a T command line is "+" , the automatic carriage return-line 
feed is suppressed. 

The %, #, and & elements are used to display the PROC buffers. These elements may 
be followed by any Reality conversion code enclosed in (:) colons. An example 
would be %2:D2, : . 

NOTE: The T Qommand assumes an attribute mark as the parameter delimiter. 






T (elementl,element.2, . . . ,element n) , 

causes oommand continuation 



Figure A. The T Command Format 



"text" 


Output data between quotes 


(X, 


Y) 


Set cursor position: X-oolurnn,, Y-row 


B 




Ring hell 


C 




Clear Screen 


In 




Output character with ASCII integer value n 


Xn 




Output character with ASCII hex value n 


Sn 




Output n spaces 


U 




Move cursor up one line 


%n 




Output nth parameter of primary input buffer 


#n 




Output nth parameter of current output buffer 


&n 




Output nth parameter of internal fast buffer 


T 




Tag 


D 




Delay 


L 




Loop 



Figure B. T Command Elements 



001 PQ 

002 T C 




003 M 




004 T (10,10,) , "DATE AND TIME", S5,+ 

005 HTIME 




006 T (10,10) ,S30,+ 

007 GO B 




Prints the date and time continuously at the 10th column and 10th row on 
the screen. 





Figure C. Sample PROC with T Command Usage 
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2.26 THE PLUS (+) , MINUS (-) , C, AND TR COMMANDS 



The Plus and Minus commands are used to add or subtract (respectively) a spe- 
cified decimal number to/from the current parameter of the currently active 
input buffer. The C command is used to place comments within the body of the 
PROC. The TR (TRace) command is used to print PROC commands as they are executed, 



The Plus (+) command has the following general form: 

+n 

This command causes the decimal number n to be added to the current parameter (as 
pointed to by the input pointer) of the currently active input buffer. The cur- 
rent parameter must be numeric . 

The Minus (-) command has the following general form: 

-n 

This command causes the decimal number n to be subtracted from the current param- 
eter (as pointed to by the input pointer) of the currently active input buffer. 
The current parameter must be numeric. 

The Plus or Minus commands will have no effect if the input pointer is currently 
at the end of the buffer. Also, the user must take care that the updated value 
of the parameter is the same length as the original value of the parameter, since 
no automatic check for this is made. Sample usage of the Plus and Minus commands 
are shown in Figure B. 

The C command is used to place comments within the body of the PROC. The general 
form of this command is as follows: 

C{text} 

All text following the C will be ignored by the PROC processor. For example: 

C THIS IS A COMMENT 

The C command may be used freely throughout the PROC for purposes of clarity and 
documentation . 

The TR (Trace) command is a debugging tool designed to assist the programmer 
with a debugging problem. Once executed, all PROC commands print on the terminal 
prior to executing. The "if" commands will print a second time if the evaluation 
was true. The Trace command remains in effect until return to TCL. 



J 



+n 

i 



deoimal number is added to ouvvent 
parametev of aotive input buffer 



i 



decimal nimber is subtracted from 
current parameter of active input 
buffer. 



C{text} 



r: 



comment is ignored by PROC processor \ 



TR 

_L 



ticm on PEOC trace 



Figure A. General Form of Plus (+) , Minus (-) , and C Commands 



PRIMARY INPUT BUFFER BEFORE COMMAND* PRIMARY INPUT BUFFER AFTER 



ABC 001 XYZ 



+99 



ABC 100 XYZ 



SECONDARY INPUT BUFFER BEFORE COMMAND** SECONDARY INPUT BUFFER AFTER 



I XXXX YY 39 



-5 



XXXX YY 34 



\ 



\ 



PRIMARY INPUT BUFFER BEFORE COMMAND* PRIMARY INPUT BUFFER AFTER 



ABC 001 XYZ 



+99 



ABC 001 XYZ 



f 



\ 



ACTIVE BUFFER PRIOR TO COMMAND EXECUTION : 

*primary input buffer 
**secondary input buffer 



Figure B. Sample Usage of Plus (+) and Minus (-) Commands 
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2.27 CALLING PROCESSORS, PROGRAM LOCKS 



The PROC processor has a Process command which may take several forms 



The P (Process) command is used by the PROC processor to execute the command which 
has been built in the primary output buffer. Functionally, temporary control is 
passed to TCL and upon completion returned to the PROC. 

The Process command with a single P (see Figure A) simply passes control to TCL. 
Variations to the P command allow additional processing to occur. The PH command 
"hushes" or suppresses system messages during execution. The PL command locks 
the PROC execution. This means that if more than one user is executing this PROC, 
the first user to reach this command "roadblocks" the other users until execution 
is complete. The PHL combines the PH and PL forms. These locks are shared with 
the BASIC and BATCH locks of the same number (0 to 63) . 

The double P (PP) version of the Process command also causes transfer to TCL; 
however, prior to processing, the contents of both output buffers are displayed 
and the user is prompted with a (?) question mark. If execution is not desired, 
a response of N is required and the PROC is ended. If execution is not desired 
but the PROC should be continued, respond with an S. This will cause the output 
buffers to be cleared. The PP command is usually used as a debugging tool. 

WARNING: A PROC may fail if it is unsituated from its location in its file while 
it is being executed. For this and other reasons^ it is good practice 
to put PROC's into dictionary level files dedicated to PROC's. 



I 



{p} p 








Process the output buffer 


{p} PH 








Process and suppress messages 


{p} PLn 








Process and look execution 


{p} PHLn 

1 1 








Process^ suppress^ and lock 




n = 


Resource 


look number {0 to GS) 




- Option 


to 


display output buffers 



Figure A. General Command Format 





END-OF-MONTH 




001 


PQ 




002 


H LIST INV LPTR 


Load the output buffer. 


003 


P 


Process the output buffer. 


004 


H SELECT MASTER WITH 


Load the primary output buffer. 


005 


H QTY > "500" 




006 


STON 


Select the "stack". 


007 


H RUN BP UPDATE 


Load the stack. 


008 


PP 


Print output buffers prior to processing. 


/ 







Figure B. Sample Usage of the Process Command 



::iiiiHiiiiii::i;::;: W^ 




NOTE: Bo indication of the first 
process command. 


SELECT MASTER WITH QTY > 


"500" 


Primary output buffer. 


RUN BP UPDATE^ 




Secondary output buffer (stack). 


? <gD 




Carriage return to continue. 


1200 ITEMS SELECTED 




Result of SELECT; would not have 
printed with the PPH form. 

Back to TCL. 



Figure C. Execution of the PROC in Figure E 
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2.28 PROC TERMINATION AND USER EXITS: THE X AND U COMMAND 



The X command causes an immediate return to TCL. The U command allows an exir 
from PROC to an assembly coded subroutine. 



The X command is used to leave a PROC and return to TCL. When the X command is 
executed, the return to TCL is immediate and no processing of the output buffers 
takes place. Any text following the X command will be output to the users ter- 
minal . 

The U command is used to exit from the PROC to a user written assembly coded sub- 
routine. The interface to PROC's is described in the appendix of this manual. 
Strict adherence to this interface will ensure compatability to future software 
releases. 



X text 
Unnnn 



Exit from PROC^ no processing^; output optional 
message to te vmi na 1 . 



' I 



-exeoutabte frame ID 



-entry povnt 



Figure A. General Command Format 



001 


PQ 




002 


IH 000 




002 


10 + 1 




003 
004 
005 


IF A = 100 X FINI! ! 


Exit from PROC and print FINI!! 


UD1A6 
GO 10 


Execute user siJbroutine. Entry point 
W of frame lASje 



Figure B. Sample Usage of X and U Commands 
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2.29 TRANSFERS AND SUBROUTINE CALLS: THE ( ), [ ], AND RTN COMMANDS 



The Link commands, denoted as ( ) or [ ] , allow other PROC s to be evoked. 



A Link command in one PROC causes control to transfer to the first command of 
ar other PROC, which may reside in any dictionary or data file. This allows the 
storage of PROC ' s (except for the LOGON PROC) outside of the M/DICT. Also, large 
PROC's can be broken into smaller PROC ' s to minimize processing time. 

If the item-ID (Figure A) is omitted, the current parameter (as specified by the 
input pointer) of the currently active input buffer is retrieved and used as the 
item-ID. The optional DICT specifies the dictionary portion of the file. 

The user should note that the PROC buffers remain unchanged when a linkage occurs. 
Also, the first line of the linked-to item is always skipped, since it is assumed 
that this line contains the PQ code. 

The parentheses ( ) form of the Link command causes a one-way transfer. 

The bracket [ ] form of the Link command allows the external subroutine capability 
for PROC's. Using this form, transfer is made to the indicated PROC, but a return 
to the "calling" PROC is made if a RTN command is executed. One PROC may call 
another PROC, which may call another PROC, etc., indefinitely. 

The RTN command is ignored if no previous Link command was executed. An optional 
value may be placed after the RTN command, which indicates that the return should 
be made n lines after the Link command. 



I 



({dict} file-name {item-name} 
[{dict} file-nam.e {item-name}] 

rtn{x} 



Figure A. General Link Command Formats and Return 



ITEM-LISTFILES 

001 PQ 

002 (DICT PROCLIB) 



Item-name is missing; transfer to item- 
name whose value is in the current 
■position of the primary input buffer. 



Figure B. Permanent Transfer 



ITEM 


- FILE-SAVE 




001 


PQ 




002 
003 


[DICT MD VERIFY-SYSTEM] 
[DICT SYSPROG-PL] 


The three PROC's must have a 
RTN command. 


004 


[DICT SYSPROG-PL FILE-STATS] 




005 


HOFF 




006 


FILE SAVE COMPLETE 




007 


P 





Figure C. PROC's as Subroutines 
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2.30 SPECIAL PROC VERBS: PQ-COMPILE AND PQ-SELECT 



The PQ-COMPILE verb compiles PROC source programs into smaller and faster 
executing "object" programs. The PQ-SELECT verb loads the designated select 
register with item-ID' s. 



The PQ-COMPILE verb (Figure A) compiles the PROC into "object" form. BRANCHES 
and GOSUB commands, in particular, will be speeded up. The PROC compiler will not 
allow the original PROC to be overlayed. Prior to compilation, the user will be 
prompted for the destination file. The compiled code is readable, but many com- 
mcQ-ids take an altered form. Also, all comments are deleted from the "object" 
or compiled version of the PROC. 

WARNING: Changing a compiled FROC with other than another PQ-COMPILE may cause 
the PROC to abort or fail when run. 

See Figure B for a sample compilation. 

The PQ-SELECT verb is used to place item-ID' s into a select register (see Figure 
A) . Note that PQ-SELECT is a system verb and must be placed in an output buffer 
and passed to the TCL processors for execution. The PQ-SELECT verb is designed to 
function following a SELECT, GET-LIST, SSELECT or FORM-LIST verb. The items 
selected are then placed in the designated select register. The item-ID 's in 
the select register may be referenced using the ( !n) form of the indirect buffer 
reference described elsewhere in this manual (see Figure D for an example) . 






PQ-COMPILE file-name item-name 



PQ-SELECT n 



-proo name 



— source ftle name 



A digit (1 through 5) 
representing the desired 
select register. 



Figure A. General Verb Formats 



: PQ-COMPILE PROC-SOURCE LISTU 
DESTINATION: PROC-LIBRARY <£. 



Figure B. Sample PROC Compilation 



9020 
9021 
9022 
9025 



COMPILATION ABORTED 

FORMAT ERROR IN LABEL 

DUPLICATE LABEL 

FORMAT ERROR IN 'GO' STATEMENT 



Figure C. PROC Compiler Messages 



001 NHSELECT SYSTEM-OBJECT 

002 STON 

003 NH PQ-SELECT 1 

004 10 P 

005 NHMVERIFY SYSTEM-OBJECT 

006 NH !1 

007 IF # #3 GO 10 

008 X DONE ! ! 



Select items from file. 

Turn on stack. 

Save item-ID' s. 

Process output buffers. 

Move verb and file name to buffer. 

Move item-ID to buffer. 

If not complete 3 branch. 

Exit and print done! ! 



Figure D. Sample Use of PQ-SELECT 
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2.31 SAMPLE PROC: FILE UPDATE VIA BATCH 



This topic presents a Scimple PROC which updates a file via the BATCH 
processor. 



The left-hand column of Figure A shows the sample dialog used to evoke the 
PROC named NEW- PART. Note that the PROC prompts the user for the required 
data. Figure A also shoves the respective content of both input buffers 
as the data are input. 

The left-hand column of Figure B shows the actual PROC listing. (The PROC 
is stored as item NEW-PART in the user's M/DICT.) Figure B also shows the 
content of both output buffers as they are affected by each PROC statement 
(and by the input data shown in Figure A) . 

Note that the TCL command to evoke the BATCH processor is being built in 
the primary output buffer, while the input lines used to feed the BATCH 
processor are being built in the secondary output buffer. The second 
carriage return in the secondary output buffer specifies a second input 
line for BATCH (i.e., a null input line). For further information re- 
garding BATCH, refer to the section in this manual titled THE BATCH 
PROCESSOR. 



INTERACTIVE DIALOG 



PRIMARY INPUT BUFFER SECONDARY INPUT BUFFER 



: NEW- PART iSR 

PART- NO 
?334 (C 



VENDOR 

? SMITH ^D 

BIN LOCATION 
?A2777 (SD 

BAD BIN NUMBER 
BIN LOCATION 
?AA27 <C1 



NEW- PART 







NEW- PART 




t 




I NEW- PART 




^ 




NEW- PART 




t 




NEW- PART 





334 



SMITH 



T 



A2777 



AA27 



T 



Figure A. Interactive Dialog and Input Buffers 



NEW- PART PI 

PQ 

OPART- NO. 

IN? 

IF A= (3N) 

X-BAD PART 

21 STON 
A 

E]6 

22 ©VENDOR 
IN? 

IF A GO 23 
GO 22 

23 A 
E]6 

24 OB IN LOG 
IN? 

IF A = (2A2 
OBAD BIN NL 
GO 24 

25 A 
H< 
H< 

STOFF 
HB/ADD MD 


^OC 

GO 21 

NUMBER - 

AT ION 

N) GO 25 
MBER 

:ENT 


PRIMARY 


OUTPUT BUFFER SECONDARY OUTPUT BUFFER 
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334 SMITH 
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334 SMITH AA27 
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334 SMITH AA2 7 (CR) 
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f 












334 SMITH AA27 (CR^ (CR) 
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i 












334 SMITH AA27 (CR^ (CR) 




f 








f 




HB/ADD 


MD 


: ENT 




334 SMITH AA27 CCR) (CR) 








f 




f 




P 


HB/ADD 


MD 


:ENT 


(£g) 


334 SMITH AA2 7 (CR) (ce) 












f 
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Figure B. PROC Listing and Output Buffers 
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2.32 SAMPLE PROC: FILE UPDATE VIA EDITOR 



This topic presents a sample PROC which changes a specified attribute 
value via the EDITOR. 



Figure A shows a sample EDITOR operation which changes attribute 3 of item 
11115 of file ACCOUNT to the value ABC. Figure B shows a PROC named CHANGE 
which will perform the exact same operation. Note that the PROC has been 
written in such a manner that it updates any specified attribute in any 
specified item in any specified file. The format used to evoke this PROC 
is as follows : 

CHANGE file item attribute-no new-value 

If, for example, the user wishes to perform the same operation shown in 
Figure A, the PROC must be evoked as follows: 

: CHANGE ACCOUNT 11115 3 ABC (CR) 

The user should note that the normal messages output by the EDITOR 
(e.g., TOP, '11115' FILED, etc.) are output when the PROC in Figure B 
is executed. These messages may be suppressed, however, by using the Z 
option when calling the EDITOR, and by preceding each EDITOR command by 
a period (.); for further information regarding these features, refer to 
the EDITOR Reference Manual. 



:EDIT ACCOUNT 11115 


-m 


TOP 




.(53 (QE) 




003 100 AVOCADO 




.R (SD 




003 ABC (Ci) 




.FI (qD 




'11115' FILED. 





Figure A. Sample EDITOR Operation 



item 'CHANGE' in M/DICT 


001 


PQ 


002 


HEDIT 


003 


A2 


004 


A3 


005 


STON 


006 


HG 


007 


A4 


008 


H< 


009 


HR< 


010 


A5 


Oil 


H< 


012 


HFK 


013 


P 



Figure B. Generalized PROC Stored As Item 'CHANGE' Which Will 
Perform Identical Operation 
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2.33 SAMPLE PROC: USING SSELECT AND COPY VERBS 



This topic presents a sample PROC which uses the SSELECT and COPY 
verbs . 



Figure A shows a sample operation at the TCL level using the SSELECT verb 
and then the COPY verb. This identical operation is performed by the 
PROC named TEST shown in Figure B. Upon execution of the TEST PROC, the 
output buffers contain the data shown in Figure C. Note that the SSELECT 
sentence is contained in the primary output buffer, while the secondary 
output buffer contains both input elements of the COPY operation, each 
terminated by a carriage return. 

For further information regarding the SSELECT verb, refer to the ENGLISH 
Reference Manual. For further information regarding the COPY verb, refer 
to the Reality Programmer's Reference Manual. 



:SSELECT rWVENTORY WITH OOH > "900" BY-DSND QOH (^ 
19 ITEMS SELECTED 
:COPy INVENTORY (QR) 
TO: (HOLD-FILE) (qE) 
19 ITEMS COPIED 



Figure A. SSELECT and COPY Operation at TCL Level 



item 'TEST' in M/DICT 

001 PO 

002 HSSELECT INVENTORY WITH QOH > "900" BY-DSND OOH 

003 STON 

004 HCOPY INVENTORY< 

005 H (HOLD-FILE) < 

006 P 



Figure B. PROC Stored as Item 'TEST' Which Performs Identical 
SSELECT and COPY Operations 



PRIMARY OUTPUT BUFFER 



SSELECT INVENTORY WITH OOH > "900" BY-DSND OOH (cr)" 



SECONDARY OUTPUT BUFFER 



:OPY INVENTO RY CR (HOLD-FILE) ~(^ 



Figure C. Output Buffers Upon Execution of TEST PROC 
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2.34 SAMPLE PROC: USING VARIABLE TESTING, GO AND D COMMANDS 



This topic presents a sample PROC which uses variable testing, GO and 
D commands . 



Figure A shows a sample tape positioning PROC. It differs from previous 
examples in that it uses the arithmetic command. It has practical value 
in that the user does not have to enter T-FWD at the TCL level for every 
file that is positioned over. 



SPACE 

001 PQ 

002 C--THIS PROC WILL T-FWD A TAPE OF (NN) FILES 

003 05 

004 OSPECIFY NUMBER OF TAPE FILES TO T-FWD 

005 OMUST BE TWO DIGITS+ 

006 S(l) 

007 IP= 

008 IF A = (2N) GO 10 

009 GO 05 

010 10 IF A = 00 GO 30 
Oil HT-ATT 

012 P 

013 HT-REW 

014 P 

015 20 D 

016 HT-FWD 

017 P 

018 S(l) 

019 -1 

020 IF A # 00 GO 20 

021 30 X...YOU ARE SPACED OUT... 



Figure A. Sample Tape Positioning PROC 
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3.1 AN INTRODUCTION TO BATCH 



The BATCH processor provides a facility for inputting, updating, and 
deleting items (or attributes) within Reality files. 



BATCH operates via a predefined "BATCH-string" and an input line, used to 
update one or more items in multiple files simultaneously. The BATCH-string 
is stored as an item in a file and provides the dictionary function for the 
subsequent update. In other words, the BATCH processor ignores the attri- 
bute defining items defined for the designated files (i.e., which are used 
by the ENGLISH language processor) , and instead relies on the BATCH-string 
to define the updating algorithm. 

BATCH is evoked by issuing one of the following commands at the TCL level: 

B/ADD file-name item-id 
B/DEL file-name item-id 

The file-name and item-id define the location of the specified BATCH-string. 
B/ADD in general defines an updating function (but may be used to delete 
items) . B/DEL provides a reversing update function, in that using B/DEL 
on the identical BATCH-string and input line will in general negate or 
reverse the effects of a previous B/ADD operation. The exact nature of a 
B/DEL operation as opposed to a B/ADD operation will become clearer as the 
user reads the remaining topics within this section. 

Once a valid B/ADD or B/DEL command has been entered, and the BATCH pro- 
cessor has gained control, the user is prompted for input lines at the 
terminal via the prompt character ">". Each input line entered by the 
user is processed separately by BATCH and generates a separate file 
update. BATCH continues to prompt for more input lines until the user 
exists by entering a null line (i.e., a carriage return only) following 
the BATCH prompt character. 

Many users store BATCH-strings in the Master Dictionary (M/DICT) , but this 
is not required. In fact, the recommended procedure is to define a separate 
file (or files) used exclusively to store BATCH-strings. These files should 
be single-level (i.e.. Dictionaries) to save an additional file access in 
retrieving the BATCH-string. Also, the most common usage of the BATCH pro- 
cessor is from a PROC, where the B/ADD or B/DEL command has been constructed 
in the PROC's primary output buffer and the input lines to BATCH have been 
constructed in the PROC's secondary output buffer. For this reason, one 
must examine both the BATCH-string and its associated PROC to fully compre- 
hend the resulting processing. (For a specific example illustrating the 
usage of BATCH in conjunction with a PROC, refer to the topic in this 
manual titled SAMPLE PROC: FILE UPDATE VIA BATCH.) 

Figure A summarizes the general forms of the B/ADD and B/DEL commands. 
Figure B presents a number of examples. 



B/ADD 


file-name itera-id 

1 1 






s-peoifies location vMeve 
desired BATCE-stvinq is stored 




B/DEL 


file-name item-id 





Figure A. General Form of BATCH Commands 



EXAMPLE EXPLANATION 

: B/ADD BATCHPILE CHANGE (^r) Evokes the BATCH processor using 

> the predefined BATCH- string 

stored as item CHANGE in file 
BATCHFILE. The operation per- 
formed is a B/ADD operation further 
defined by the input line entered 

by the user immediately after the ">" 
prompt character. 

tW^Mmmmm§mmmmiP:imwm^S- Evokes the batch processor using 

> the predefined BATCH- string 

stored as item UPDATE in file 
BATCH-STRTNGS . The operation 
performed is a B/DEL operation 
defined by the input line entered 
by the user immediately after the 
">" prompt character. 



Figure B. Sample Usage of BATCH Commands 
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3 THE BATCH PROCESSOR 
3.2 BATCH- STRINGS 



A BATCH-string is a definition of the updating algorithm to be performed, 
BATCH-strings are stored as Reality file items. 



A BATCH-string consists of a set of "elements", one "element" per line 
(attribute) . In general, a BATCH-string consists of the following elements 
for each file item to be updated: a file defining element, followed by one 
attribute defining element for each attribute, followed by a Z element. 
This sequence is repeated for each file item to be updated by the BATCH- 
string. (The Z elements separate the file item update sequences.) 

Each element in the BATCH-string begins with a mnemonic identifying the 
element type (the sole exception being the file defining element which has 
no mnemonic and appears as the first element in the BATCH-string and as 
the first element following each F element) . The mnemonic is optionally 
followed by modifiers and sub-elements delimited by commas. These modi- 
fiers and sub-elements are defined in subsequent topics which discuss each 
element type in detail. 

The entire update resulting from a BATCH-string is accumulated and processes 
in a single step. Any errors encountered during the processing of the BATCH- 
string aborts the process and thus none of the updates occur. Additionally, 
multiple updates to the same file item cannot be performed by the same 
BATCH-string; the last file item update will override any previously genera- 
ted updates by the BATCH-string to the same file item. 

There is a one-to-one correspondence between atrribute defining elements in 
the BATCH-string and the defined attribute values themselves. In other 
words, the Attribute Mark Count (AMC) is not explicitly specified in the 
element, but is implied by the sequence of attribute defining elements. 
This principle is illustrated by the example shown in Figures A through D. 

Figure A shows item 123 in file XYZ before the update takes place. The 
BATCH-string is stored as item UPDATE in file BATCH, as illustrated in 
Figure B. Figure C shows the B/ADD command and associated input line 
entered by the user. Finally, Figure D shows item 123 after the update 
has been performed. The user should note that the 123 in the input line 
(see Figure C) "feeds" the BATCH-string and provides the item-id to accom- 
pciny file defining element XYZ, I (see Figure B) , thus specifying that 
item 123 of file XYZ is to be updated. The two N elements in the BATCH- 
string (see Figure B) direct the BATCH processor to ignore (nop) the first 
two attribute values (ABC and DEF) . The JKLM in the input line (see 
Figure C) "feeds" attribute defining element A,Y21 (see Figure B) and 
directs the BATCH processor to replace the old attribute value (GHI) with 
the new value (JKLM) from the input line, thus producing the updated item 
shown in Figure C. (Note that the BATCH-string in Figure B does not in- 
clude a Z element since an update is being defined for one file item only.) 



item 12 3 in file XYZ 

001 ABC 

002 DEF 

003 GHI 



Figure A. Item 12 3 Before Update 



item UPDATE in file BATCH 

001 XYZ,l-^i file defining element 

002 N-< attribute defining element 

003 N*^ attribute defining element 

004 A,Y21-< attribute defining element 



Figure B. BATCH-String Stored As Item UPDATE in File BATCH 



:B/ADD BATCH UPDATE ££)-• BATCE command 

>123„JKLM (5D-« ^ input line 

>Cr)"* terminates BATCH 



Figure C. BATCH Command and Associated Input Line 



item 123 in file XYZ 

001 ABC 

002 DEF 

003 JKLM 



Figure D. Item 123 After Update 
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3 THE BATCH PROCESSOR 
3.3 INPUT LINES 



BATCH-string elements reference fields in input lines. The user enter 
input lines in response to the ">" prompt character. 



Once the BATCH processor has been evoked via a B/ADD or B/DEL command, 
the user is prompted for input lines at the terminal. Each input line 
entered by the user is used to generate a separate file item update. 
The BATCH processor continued to prompt for input lines until the user 
enters a null input line (carriage return only) at which point control 
returns to TCL. 

Values from an input line may be referenced by a BATCH-string element in 
either a free-field or fixed-field format. BATCH uses an input line pointer 
to keep track of data in the input line. Each file defining or attribute 
defining BATCH-string element uses one value from the input line; at the 
conclusion of this usage the input line pointer is advanced to the charac- 
ter immediately following the previously used value. Special BATCH-string 
elements are available which permit movement of this pointer so that the 
same value from the input-line may be used repetitively (refer to the 
topic titled ADDITIONAL BATCH-STRING ELEMENTS AND SUB- ELEMENTS) . 

An input line value referenced by a BATCH-string element in the free- field 
format is considered as starting with the first non-blank character at or 
after the current position of the input pointer, and continuing up to (but 
not including) the next blank. Values with imbedded blanks may be created 
in the input line by surrounding the entire value with single quotes (e.g., 
'ABC DEF"), or by replacing the imbedded blank with a backslash (e.g., 
ABCNDEF) . A backslash surrounded by blanks represents a null (missing) 
VcLlue . 

Fixed-field input line values may be referenced by BATCH-string elements 
by specifying a starting column number and a field width. Fixed- field 
values always contain the number of characters specified and may contain 
en±)edded blanks. All leading and trailing blanks are deleted. Two or 
more contiguous blanks are considered to only one blank. 

Rather than using explicit input line values, the first input line entered 
mciy optionally be one of special input line formats listed in Figure A. 
These special input line formats specify that the actual input values are 
to be obtained from a prestored file item, or from the attached magnetic 
t£ipe unit. 

Sample input lines are depicted in Figure B. 



value value value 



actual values ave used 



({DICT} file-name itein-id)« 



(tape{c}) 

(TAPE {a}) 



or •*«- 



Instructs BATCH to use the speci- 
fied item as the input data 
stream. Each attribute value 
(line) in the item is treated as 
a separate input line (each line 
may he up to 511 bytes in length). 
The DICT option specifies the 
dictionary section of the file. 



Instructs BATCH to read data from 
the tape unit. Each fixed length 
unblocked tape record (maximum of 
511 bytes) is treated as one in- 
put line. The C option specifies 
EBCDIC to ASCII conversion. The 
A option specifies masking to 
7 -bit ASCII. 



Figure A. General Form of Input Line 



:B/AD TESTFILE TESTITEM llHl'^- 
>987 ABC 'BB CCC 
>ia3 XYS GC/HHH 



'BATCH command 

■ 1st input line. 

■ 2nd input line 
■terminates BATCH 



:B/ADD FNA CHG 
>45 ,XXX2 97300 ABB 



BATCH command 
single input line 
■terminates BATCH 



:B/DEL XYZ 123 
>(PII.EX T7) (C, 






:B/ADD FNl UPDATE 
>(TAPE A) (S)-^ — 



•BATCH command 

■Specifies that input lines are to 
be obtained from item T7 in file FILEX 

-BATCH command 

■Specifies that input lines are 
to read from tape. 



Figure B. Sample Input Lines 
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3.4 BATCH-STRING FILE DEFINING ELEMENTS 



The BATCH-string file defining element generates a specific item-id in 
a file to be updated. 



The first element in a BATCH-string is a file defining element. A BATCH- 
string may contain additional file-defining elem,ents immediately following 
a Z element. The first file specified is called the primary file; other 
files are called secondary files. The general form of the file defining 
element is as follows : 

{dict} file,code{ (loc) }{,C(loc) }. . . {,conv}. . .{, bridge}. . .{, other}. . . 

The "file" specification names the file containing the time to be updated. 
If the DICT option is used, then a dictionary item is updated. 

The "code" specification may be any one of the following: 

I - Update existing item or create new one. 

N - Overwrite existing item. 

V - Verify that item exists; abort otherwise. 

X - Delete existing item. 

A - Verify item does not exist; abort otherwise 

The "(loc)" option immediately following the "code" specifies the location 
(in the input line) of the value used as the item-id. (If the "(loc)" option 
is not used, then free-field format is assumed, with the field used as the 
item-id beginning at the next nonblank input line character and continuing 
to the next blank.) The "(loc)" option may be any one of the following: 

(m,n) - Use n characters starting at column m. 

(m) - Use characters from column m up to first blank encountered. 

(,n) - Use n characters starting at current pointer position. 

p - Use p'th field of input line. 

The "C(loc)" option specifies that another value is to be concatenated onto 
the end of the value specified by "(loc)", thus forming the desired item-id. 
Multiple "C(loc)" specifications are permitted. The "C(loc)" option may 
be any one of the following: 

C(m,n) - Concatenate n characters starting at column n. 

C (m) - Concatenate characters from column m up to first blank 

encountered. 
C(,n) - Concatenate n characters starting at current pointer 

position. 
Cp - Concatenate p'th field. 

The "conv" option specifies input data conversions. Any conversion code 
defined in the CONVERSIONS section of the Reality ENGLISH Reference 
Manual may be used here (except for the Concatenate Code) . 

The "bridge" option may be either BC (n) or BV(n), and may be used for 
secondary files only. This option specifies that item-id is created 
(BC) or verified (BV) from the attribute value with Attribute-Mark-Count 
(AMC) "n", in the primary file item (in new item image). Multiple "bridge" 
specifications may be repeated to specify concatenated item-id's, or may 
be combined with I, J, K, or C siib-elements as needed. (Note: If the 



attribute is multi-valuead, it is the first element of a concatenated "bridge" 
specification; D2 attributes should not be used with a "bridge" specification) 

The "other" options may be any of the additional sub-elements described in 
the topic titled ADDITIONAL BATCH-STRING ELEMENTS AND SUB-ELEMENTS. 



{dict} file,code{ (loc) }{,C(loc) }. . . {,conv}. . . {, bridge). . . {, other} 



Qonvevs^on, 
code 



'on\ 



BC(n) or 
BV(n) 



add-itional 
sub- elements 



C(m^n) or C(m)~ov C(^n) or Cp (see note) \ 



(m„n) or (m) or ( ^n) or p (see note) 



I - update item 

N - overwrite item 

V - verify existence 

X - delete item 

A - verify non-existence 



NOTE: m is column nimber 

n is number of characters 
p specifies p'th field 



Figure A. General Form of BATCH-String File Defining Element 



The examples below assume the following input line: 
1234 ABC XYZ 987 



FILE DEFINING ELEMENT 
FNA,I 

INVENTORY, X( 6, 2) 
FILEX, 1(3,2) ,C2 

FNB,N,C(6,1) ,C(13,3) 
FNB,N,C(6,1) ,C(13,3) ,MT 



E XPLANATION 

Item with item-id 1234 in file FN A is 
updated. 

Item with item-id AB in file INVENTORY 
is deleted. 

Item with item-id 34ABC in file FILEX 
is updated. 

Item with item-id 1234A987 in file 
FNB is overwritten. 

Same as above^ but Time Conversion is 
specified (see ENGLISH Reference 
Manual) . 



Figure B. Sample Usage of BATCH-String File Defining Elements 
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3 THE BATCH PROCESSOR 

3.5 BATCH- STRING ATTRIBUTE DEFINING ELEMENTS 



The BATCH-string attribute defining elements define the operation 
performed on the corresponding attribute value. 



Following the file defining element in a BATCH-string there must be one and 
only one) attribute defining element for each attribute to be updated. The 
attribute defining element and the actual attribute in the file have a one- 
to-one positional relationship. Attributes not updated beyond the last 
updated attribute need not be represented in the BATCH-string. There 
are five types of attribute defining elements: A, D, N, T, and X. The 
A type has the following general form: 

a{ (loc) }{,C(loc)}. . . {,conv}. . . {, other}. . . ,code 

The "(loc)" and "C(loc)" options define the value used from the input 
string; these specifications (as well as the "conv" and "other" options) 
are identical to the forms described for the BATCH-string file defining 
elements (refer to that topic). The "code" specification, which defines 
the operation performed, may be any one of the following: 

Yll - Store unique multiple values (i.e., won't store if value 

already present) . 
Y12 - Store non-unique multiple values. 
Y21 - Replace a single value. 
Y22 - Abort BATCH-string if any value already present; insert 

value if sttribute is null. 
Y2 3 - Ignore if any value already present; insert value if 

attribute is null. 
Y31 - Add value to attribute (subtract for B/DEL) . 
Y32 - Subtract value from attribute (add for B/DEL) . 
Y33 - Add 1 to attribute (subtract for B/DEL) . 
Y41 - Store multiple unique values in ascending ASCII collating 

sequence; not used with associative attributes. 
Y42 - Same as Y41, but redundant values are also stored. 

Additionally, a 4 may be suffixed to the "code" to place a "negative 
balance not permitted" restriction on the result (e.g., Y324) . 

If the attribute to be modified is an associative attribute (refer to 
the ENGLISH Reference Manual) , then the D type is used. The D type 
takes on the following general forms : 

Dl;x{ (loc) }{,C(loc) }. . . {,conv}. . . {, other}. . . ,code 
D2;x{ (loc) }{,C(loc) }. . . {,conv}. . .{, other}. . . ,code 

The primary associative attribute is identified by Dl;x. Subsequent secondary 
associative attributes are identified by D2;x. Three sets of associative 
attributes may be processed by BATCH (x is 1, 2, or 3, thus identifying the 
set) . The remaining specifications of the D type attribute defining element 
are the same as defined for the A type above. 

The N, T, and X type attribute defining elements are as follows: 

N - Ignore corresponding attribute 

nN - Ignore next n attributes 

T - Add 1 to corresponding attribute (for both B/ADD and B/DEL) . 

X - Delete corresponding attribute 

A complete BATCH example illustrating the use of the attribute defining 
elements is presented in the topic titled A COMPLETE BATCH EXAMPLE. 



a{(1oc) }{,C(1oc) }. . .{,conv}, 
T I i. 



{ , other} 



define value to be used 
(same as desorihed for 
f'ile defining e lement) __ 



,code 



111 - stove non-vedundantly 

Y12 - stove vedundantly 

121 - veplaoe single value 

i22 - vejeot if any value pvesent 

Y23 - ignove if any value pvesent 

Y31 - add to existent value 

Y32 - subtvaot fvom existent value 

Y33 - add 1 to existent value 

Y41 - sequence unique values 

(ascending) 
Y42 - sequence all values 
(ascending) 



Figure A. General Form of BATCH-Strincj Attribute Defining Element (A Type) 



i dentifies pvimavy associates attvibute \ 



Dl;x{ (Ipc) }{,C(loc) }. . . {,conv}. . . {, other}. . . .code 



same a s defi n ed in Figuve A above 



[x^ is 1^ 2 J ov 3 ( pvovid ing fov 3 set sj\ 



_sgme as defined in Figuve A ab ove 



L)^;xt (loc) }{,C(loc) }. , . {,conv}. . .{, other}. . . ,code 



\ia 



identifies secondavy associative attvibu te 



Figure B. General Form of BATCH-String Attribute Defining Element (D Type) 



N^ 



^ignove covvesponding attvibute 



T- 
X - 



^gnove n attvibutes 



add 1 to covvesponding attvibute 



delete covvesyonding attvibute 



Figure C. General Forms of BATCH-String Attribute Defining Elements (N, 
T, and X Types) 
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3 THE BATCH PROCESSOR 

:3.6 ADDITIONAL BATCH-STRING ELEMENTS AND SUB-ELEMENTS 



In addition to file defining and attribute defining elements, four addi- 
tional BATCH-string elements are provided. Additional sub-elements 
which may be used in both file defining and attribute defining BATCH- 
string elements are also provided. 



Additional Elements 



The following elements may be used in a BATCH-string. 

F - Move the pointer forward to the next field in input line. 
B - Move pointer backward one field in input line. 
S(m) - Set pointer to m'th column in input line. 

Z - Terminate a file item update section (must be immediately 
followed by another file item update section) . 

These elements are exemplified in the topic titled A COMPLETE BATCH EXAMPLE. 

Additional Sub-Elements 

The additional sub-elements described below may be used (unless otherwise 
specified) in both file defining and attribute defining BATCH-string elements. 

The F sub-element specifies arithmetic operations on the input line data. 
Its general form is: { ,Fop{ (loc}} . . . 

The "op" specification specifies the operation to be performed, as listed 
in Figure C. The "loc" specification specifies the second operand of the 
arithmetic operation; the first operand of the operation is the value which 
has previously been extracted (generated) by the BATCH-string element. The 
"loc" specification takes on the same general form as described for the 
attribute definition element (refer to that topic). For example, assuming 
an input line of "12 3 456" and an attribute defining element of 
"A2,F- (2,2) ,Y21" the resultant value stored would be "433". 

The U sub-element exists to a user-defined subroutine. It's general 
form is: {,Uxxxx} 

where xxx is the hexadecimal mode-id of the subroutine. 

The SH and SD sub-elements store the system time and system date, repectively. 
The general forms are as follows: {,SH} {,SD} 

No input data is necessary for either of these sub-elements if they immediately 

follow the A, Dl, or D2 . 

The J sub-element has the following general form: {,J(n)} 

This sub-element should only occur for secondary file attributes. It is 
ignored if the update is a B/ADD or if the update is a B/DEL with some 
specific data input to the field used by this element. If no data are input 
(meaning delete the entire value in the attribute), then the n'th primary 
file attribute is referenced, and the value that was deleted there is also 
deleted from the secondary file attribute. Only the first value used in the 
delete processing is used. Consequently, multi-valued primary attributes 
are in general processed incorrectly. The sub-element must be specified 
if the primary item itself is to be deleted. An example illustrating the 
use of the J sub-element is presented in the topic titled: SAMPLE USAGE OF 
B/DEL COMMAND WITH J SUB-ELEMENT. 



B .*- 



moves pointer forward one field 



moves pointer backward one field 



S(m).<- 



sets pointer to m^th colimn 



z -^ 



terminates file item update section 



Figure A. General Form of F, B, S (m) , and Z BATCH-String Elements 



{,Fop{ (loc}}. . . -<- 

{,Uxxxx} -^i 

{,SD} -^ 

{,sh} -< 



specifies arithmetic operation (see Fig. C) \ 



specifies exit to user- subroutine 



stores system date 



stores system time 



{,J(n) }^ 



see text for description 



Figure B. General Form of F, U, SD, SH, and J BATCH-String Sub-Elements 



SYMBOL 



OPERATION 

Addition 

Subtraction 

Division 

Multiplication (if the n option is used^ 
it must be a positive number and will be 
used as a scaling factor^ i.e.^ the product 
will be divided by 10^) 



Figure C. F Sub-Element "op" Specification Symbols 
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3.7 BATCH- LOCKS AND THE CONTINUATION CHARACTER 



A BATCH-lock is a "gate" which restricts concurrent access to a BATCH- 
string. The continuation character feature overcomes the 140-character 
restriction which normally applies to a BATCH input line. 



B ATCH-Locks 

A BATCH-lock is a BATCH-string element which denies or permits access to 
the associated BATCH-string. If a potential user is denied access, he 
is put in a wait loop until access is permitted. The purpose of a BATCH- 
lock is to protect the current user until he has concluded execution of a 
BATCH-string (i.e., protects against concurrent access). 

A BATCH-string is locked by a code upon entering, and unlocked automatically 
upon exiting. The format for the BATCH-lock is: 

L (code) 

where "code is a number from 1 through 8 (inclusive) . 

All BATCH-strings using the same code are locked when any one of them 
is in use. Typically all BATCH-strings of an application system (e.g., 
payroll, inventory, etc.) share the same lock code, by user convention. 
A lock code should be the first line (element) of a BATCH-string, but may 
precede any file-definition element. Figure C illustrates a sample BATCH- 
string with lock code 5. 

In the event that the execution of a BATCH-string is interrupted by an 
abnormal abort or by the BREAK key, an automatic unlock will not occur . 
A TCL verb to unlock all codes is provided. Its general form is: 

B/UNLOCK {d} 

where the "d" option is the decimal equivalent of an ASCII character to be 
used as the user's "lock-character". The lock character is displayed when- 
ever the user's lock code is set into the lock state. For example, con- 
sider the following command issued at the TCL level: 



:B/UKLOCK 96 CCR; 

This example displays a pound sign (#) whenever the lock code was set 

via execution of a BATCH-string. Note that the lock character option need 

only be established once. 

C ontinuation Character 

The continuation character feature is useful when using BATCH in conjunction 
with a PROC. The PROC output buffers are infinitely long; however, BATCH 
only accepts a maximum of 140 characters as an input line. To overcome 



this restriction, the user may place a second carriage return specifica- 
tion (<) in the PROC stack (refer to the topic describing the H command in 
the PROC section of this manual) . A carriage return specification appear- 
ing as the next-to~last character in the stack is interpreted as a 
continuation character. For example: 



12 34 ABC DEF « 
Glil JKL << 



The next-to-last "<" symbol is the continuation character and the last "<" 
symbol is the carriage return. The two lines in the example are processed 



as one . 



L (code) 



a numhev 1 through 10 



Figure A. General Form of BATCH- Lock Element 



B/UNLOCK {d} 



look charaoter 



Figure B. General Form of B/UNLOCK TCL Verb 



001 


L(5) 


002 


ACCOUNT , I 


003 


A,Y21 


004 


UN 


005 


A,Y21 



Figure C. Sample BATCH-String Using BATCH-Lock Element 
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3.8 A COMPI.ETE BATCH EXAMPLE 



This topic presents a graphic example of a complete BATCH update 
operation. 



The example in Figure A illustrates the update of item 99-A in the PO- 
NUMBER file. The update is accomplished via the BATCH-string stored 
as item UPD-PO in the BS file. The arrows illustrate the interrelation- 
ship among the input line, the BATCH-string elements, and the updated 
item. The reader should follow each arrow carefully, taking notice of 
how each BATCH-string element interacts with its specified input line 
field, thus producing the associated updates to item 99-A. 

iln addition, the reader should note than an item with item-id 12 in the 
TRANS FILE (a secondary file) is also created by this sample operation. 



item 



< 



n file PO-NUMBER before update 



001 


ABC 


002 


10 


003 


11 


004 


22 


005 


29 OCT 1974 


006 


$ 0.33 


007 


-44 


008 


1 


009 


9 


010 


33*44 


Oil 


44 


012 


31 OCT 1974 



BATCH-string execution 



:B/ADD^S IIPD-P0<gg)- 



n 



>99-ra ii 34 11/2/74 56-78 90 (gS) 

^' 



tern 99-A in file PO-NUMBER after u^. 



-►item UPD-PO in file BS 



-►001 PO-NUMBER, I ■ 

002 N 

003 T^ 



-►001 ABC 
-►002 11 



-►004 A,Y11- 
-►005 A,Y12 



-►003 11 12 
-►004 34 22 
-►005 02 NOV 1974 

006 $ 0.89'^ 

007 -122'< ■ 

008 2M . 



009 10^ 



010 56*78^ 
Oil 78^ 



012 31 OCT 1974* 



•006 A,D,Y21- 
-►007 A,Y31 — 

-►008 A,Y32 

-►009 A,Y33 — 



w 

00 



n 



010 Al,TPO-NUMBER;V;2;2,Y21- 

011 F 

012 F 

013 F 

014 A,C,Y21^ . 

015 B 

►016 A,Y21 

017 A,SD,Y21 __ 

018 Z 

019 TRANS, 12 ■ 

•020 A2,F+,Y21 ■ 



r 



-►item 12 in file TRANS 



-►001 46 



Figure A. Sample BATCH-String Update 



3 THE BATCH PROCESSOR 

3.9 SAMPLE USAGE OF B/DEL COMMAND WITH J SUB-ELEMENT 



The B/DEL command allows the user to delete specific values from attributes 
in an item. 



In general, the B/DEL command is used to delete specified values from one 
or more single of multi-valued attributes, or to delete implied values 
(not specified) in single-valued attributes. In addition, such implied 
values may also be accessed by the "secondary file" section (s) of the 
BATCH-string. Thus it is possible to delete a value from an attribute 
in the primary file without knowing what the value on file is, and to use 
this same value as implied inputs to attribute defining elements in secon- 
dary files. 

AS a specific example, suppose that attribute 5 of the file ACCOUNT contains 
a value that is to be zeroed at the end of a month, and that this value is 
to be added in to attribute 6 of the file HISTORY. A representative BATCH- 
string is illustrated in Figure A. 

If the value to be deleted is known (e.g., 99), then the input for this 
BATCH-string is as shown in Figure B (assuming an item-id of '123'). 
This input causes the value 99 to be subtracted from attribute 5 of the 
ACCOUNT file (see line 003) , and causes the same value to be added to 
attribute 6 of the HISTORY file (see line 007) . Note the reversal of 
the Y31 and Y32 specifications. In this case the "J(5)" sub-element m 
line 007 is not used. 

If, however, the value to be deleted is not known (or if the user does not 
wish to enter the value, then the input is as shown in Figure C, or 
optionally as shown in Figure D. In this case the element in line 003 
causes the deletion of the value in attribute 5 of ACCOUNT (as before) ; the 
"J(5)" sub-element is used to "link" back to the primary file (ACCOUNT) and 
to add in the value to the HISTORY file. 

Note that the same effect could have been achieved (at significantly greater 
processing cost) by a suitable BATCH-string employing Translate Conversions 
to pick up the values to be deleted (refer to the ENGLISH Reference Manual) . 
However, if the primary attribute is multi-valued and one of the values is 
deleted, the "J" sub-element must be used to delete the corresponding value 
in a secondary file. 

If the primary item itself is deleted (using the ",X" option in the file 
defining element) , the "J" sub-elements can add or delete values into 
secondary file attributes. 



item 


CHANGE in fi 


le BATCH- 


-FILE 




001 


ACCOUNT 


,1 






002 


4N 








003 


A,Y31 








004 


Z 








005 


HISTORY 


,11 






006 


5N 








007 


A2,J(5) 


,Y32 





Figure A. BATCH-String Stored as Item CHANGE 
In File BATCH-FILE 



:B/DE;L BATCH-FILE CHANGE^ 
>123 99 (qD 



Figure B.. Sample Input When Value Known 




Figure C. Sample Input When Value Not Known 




Figure D. Optional Input When Value Not Known 
(Produces Same Results as Figure C) 
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3.10 SAMPLE USAGE OF BATCH WITH SELECT AND SSELECT VERB 



This topic presents two examples of illustrating the use of BATCH in 
conjunction with the SELECT and SSELECT verbs. (For further information 
regarding these verbs, refer to the ENGLISH Reference Manual.) 



When evoking the BATCH processor immediately after performing a SELECT 

or SSELECT operation, at least one "item-id substitution code" (i.e., 

an asterisk (*) character) must be in the BATCH input line in place 

of the normally explicit item-id. More than one asterisk is permitted, 

with each automatically being replaced by the item-id currently being 

processed. Only one BATCH input line is allowed after a SELECT or SSELECT 

operation. 

Figure A illustrates a SELECT operation on the PAYROLL file. The BATCH- 
string stored as item DELETE in the dictionary of the PAYROLL file is 
then executed. The asterisk entered as the input line essentially causes 
each selected item-id to in turn be "picked up" and processed by the BATCH- 
string (i.e., all 5 selected items are deleted). 

Figure B illustrates a SELECT operation on the PAYROLL file. The BATCH- 
string stored as item DELETE in the dictionary of the PAYROLL file is 
then executed. The asterisk entered as the input line essentially causes 
each selected item-id to in turn be "picked up" and processed by the 
BATCH-string (i.e., all 5 selected items are deleted). 

Figure B illustrates an SSELECT operation on the ACCOUNT file. The BATCH- 
string stored as item UPDATE-ACCOUNT in the BATCHS file is then executed. 

The user should note that the following error message will be displayed 
if at least one asterisk is not used in input line: 

DATA INPUT LINE TO BATCH AFTER A SELECT MUST CONTAIN 
AT LEAST ONE ITEM- ID SUBSTITUTION CODE (ASTERISK*) 



.•SELECT PAYROLL WITH CODE "T" (S) 

5 ITEMS SELECTED. 

:B/ADD DICT PAYROLL DELETE (CR) 



•578A' UPDATED 

'592A' UPDATED 

'522A' UPDATED 

'599A' UPDATED 

'621A' UPDATED 



Figure A. Sample Usage of BATCH With SELECT Verb 



iSSELECT ACCOUNT WITH SEWER- ASMT (S) 

3 ITEMS SELECTED. 

:B/ADD BATCHES UPDATE-ACCOUNT (Cg 

>* 2.00 * 3.00 * 4,00 (£} 

•23070' UPDATED 
'25025' UPDATED 
'25050' UPDATED 



Figure B. Sample Usage of BATCH With SSELECT Verb 
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PROC COMMAND SUMMARY 



This appendix presents the general form for each PROC command. The commands 
are listed in alphabetical order. For further information regarding a par- 
ticular command, refer to the topic reference. 



C OMMAND FORMAT 

A{c}{({m}{,n})x 

A{c}{p}x 

B 

BO 

C{text} 

D(m) {+} 

D{p}{+} 

({diCt} file-name {item-id}) 

F 

F;El;E2;En 

F-CLEAR n{file} 

f-delete x 
f-free{xy} 

F-OPEN n{file} 

f-read{xy} 

f-uread{xy} 

f-write{xy} 

FB(file) 
E'BU(file) 

g; n 

CO n 

GOSUB n 

H{text}{<} 

IF {#}a-cmnd proc-cmd 

IF a-cmnd op (pattern) proc-cmnd 

IF a-cmnd op string proc-cmnd 

IH{text} 

IN{r} 

Ip{B}{r} 

it{c}{a} 

L El,E2,En 

MV operand operand 

MVA operand operand 

MVD operand operand 

-hn 

-n 

NA{c}{p}x 

NB 

NBO 

NF 

NH{text}{<} 



TOPIC 



2. 


8 


2. 


8 


2. 


7 


2. 


7 


2. 


26 


2. 


12 


2. 


12 


2. 


29 


2. 


7 


2. 


23 


2. 


19 


2. 


20 


2. 


22 


2. 


19 


2. 


20 


2. 


22 


2 


20 


2 


21 


2 


22 


2 


.14 


2 


.14 


2 


.14 


2 


.13 


2 


.15 


2 


.17 


2 


.16 


2 


.13 


2 


.11 


2 


.11 


2 


.11 


2 


.24 


2 


.9 


2 


.10 


2 


.10 


2 


.26 


2 


.26 


2 


.8 


2 


.7 


2 


.7 


2 


.7 
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COMMAND FORMAT TOPIC 

NIH{text} 

NIN{r} 

NIP{B}{r} 

nit{c}{a} 

NS(m) 

0{text}{+} 

P {mode -id} 

PP 

PQ-COMPILE 

PQ-SELECT 

RI(m) 

Rl{p} 

RO 

RSUB n 

rtn{x} 

S(m) 

SP 

ST OFF 

ST ON 

T El,E2,En 

TR 

Umode-id 

:X{text} 



2 


.13 


2 


.11 


2 


.11 


2 


.11 


2 


.7 


2 


.12 


2 


.27 


2 


.27 


2, 


.30 


2, 


.30 


2, 


.13 


2. 


.13 


2. 


,13 


2. 


,14 


2. 


.29 


2. 


7 


2. 


7 


2. 


7 


2. 


7 


2. 


25 


2. 


26 


2. 


28 


2. 


28 
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APPENDIX B 

LIST OF ASCII CODES 



This appendix presents a list of ASCII codes used in the Reality system. 



DECIMAL HEX CHARACTER SPECIAL USE IN REALITY 

NUL Null prompt character 

1 1 SOH ^/k Cursor home on CRT Terminal 

2 
3 

4 

6 6 ACK ^ p Cursor forward on CRT Terminal 



7 7 BEL -1 (y Bell on CRT Terminal 



9 
10 
11 






NUL 




1 


SOH 


^1^ 


2 


STX 


aB 


3 


ETX 


^t 


4 
5 


EOT 
ENQ 


A t 


6 


ACK 


Af. 


7 


BEL 


A if 


8 


BS 


A H 


9 


HT 


* 4 


A 


LF 


n «^ 


B 


VT 


aK 


C 


FF 


-^L 


D 


CR 


4 /V| 


E 


SO 


A N 


F 


SI 


^^ 


10 


DLE 


^P 


11 


DCl 


-^a 


12 


DC2 


^K 


13 


DC3 


/i K 


14 


DC4 


A f 


15 


NAK 


-u 


16 


SYN 


n V 


17 


ETB 


A fyf 


18 


CAN 


t X 


19 


EM 


.=% y 


lA 


SUB 


-'Z 


IB 


ESC 




IC 


FS 




ID 


OS 




IE 


RS 




IF 


US 




20 


SPACE 


21 


J 




22 


M 




23 


// 




24 


$ 




25 


% 




26 


& 




27 


T 




28 


( 




29 


) 




2A 


•k 




2B 


+ 




2C 


> 




2D 


- 




2E 


. 




2F 


/ 




30 








Cursor down on CRT Terminal 
Vertical address on CRT Terminal 
^2 c FF '^ [_ Screen erase on CRT Terminal 

2_3 D CR '1 M Carriage return on CRT Terminal 

14 

15 _ - ,^ . 

2_5 10 DLE ^P Horizontal address on CRT Terminal 

17 
18 
19 

20 - . , 

21 15 NAK A (J Cursor back on CRT Terminal 

22 
23 
24 

25 -- . . T 

25 2.A SUB -^ X Cursor up on CRT Terminal 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 
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CliARACTER 


49 


31 


1 


50 
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2 
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3 
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4 
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B 


67 


43 


C 
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D 
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45 


E 


70 


46 


F' 


71 


47 


G 
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48 


H 


73 


49 


I 


74 


4A 
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76 


AC 
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78 


4E 
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50 
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52 
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54 


T 


85 


55 
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86 


56 


y 


87 


57 


w 


88 


58 


X 
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59 


Y 


90 
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91 


5B 
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92 


5C 
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93 


5D 
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94 


5E 
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7B 


T 


124 


7C 
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7D 


} 
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7E 
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7F 


DEL 


251 


FB 


SB 
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FC 


SVM 
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FD 


VM 


254 


FE 


AM 


255 


FF 


SM 



SPECIAL USE IN REALITY 



Start Buffer 
Secondary Value Mark 
Value Mark 
Attribute Mark 
Segment Mark 



B.l 



APPENDIX C 

ASSEMBLY INTERFACE FOR PROC USER EXITS 






User exits from PROC may be used to reach special purpose assembly code 



A user program can gain control during execution of a PROC by using the UXXXX com- 
mand where XXXX is the hex mode-id of the user program. The assembly program can 
perform special processing, and then return control to the PROC processor. This 
material reproduces what is contained in the ASSY Language Manual. 



1 INPUT INTERFACE 


PQFLG 


B 


BASE 


D 


MODULO 


T 


SEPAR 


T 


PQBEG 


S 


PQEND 


S 


PQCUR 


S 


*R9 


R 


*PQ-REG 


S 


IR 


R 


PBUFBEG 


S 



^ISBEG 



'STKBEG 



*SFLG 
IB 



*PQ-CUR-IB B 



SC2 



IS 



UPD 



Set, indicating that a PROC is being executed. 
Base of the M/DICT. 
Modulo of the M/DICT. 
Separation of the M/DICT. 

Points one prior to the first PROC statement. This will be 
within the file in which the PROC resides. 
Points to the terminal AM of the PROC. 
Points to the AM following the UXXXX statement. 
Points to the PROC control block. R9 may be altered within 
the code, with the consideration that elements defined relative 
to R9 (see PQ-CUR-IB) will not be available. 
Points to the PROC control block. 
Same as PQCUR. 

Points to a buffer containing the primary and secondary input 
buffers. Format: 

(SB) . . .primary input. . . (SM) (SB) . . .secondary input. . . (SM) . 
LOGON sets this to one frame. Additional frames are added as 
needed by subroutine PQNEXTOVF. Additional frames are released 
at LOGOFF. 

Points one before the 1st character of the primary output 
buffer. This is the processor's "IS" work area. This buffer 
is and must always be terminated with a (SM) . 
Points one before the 1st character of the secondary output 
buffer (STACK). This is initially 2 linked frames, though 
more frames may be linked to it automatically by the sub- 
routine PQNEXTOVF. Additional frames are released at LOGOFF. 
This buffer is and must be terminated by a (SM) . 
Set if 'STACK ON'. Zero otherwise. 

Input buffer pointer. Points to the current location in which- 
ever is active: the primary or secondary input buffer. 
Set if IB points into the secondary input buffer. Zero other- 
wise. This bit is defined relative to register 9, which must 
be set to the PROC control block in order to reference this 
bit. 

Contains a blank. 
SFLG OFF 

The last byte of the 
primary output buffer. 
The last byte of the 
secondary output buffer. 



SFLG ON 

The last byte of the 
secondary output buffer. 
The last byte of the 
primary output buffer. 



An * notes a change from previous conventions. Note in particular that SFLG re- 
places SBIT, that attribute marks may separate parameters, and that a (SM) termi- 
nates each PROC buffer. 



I 



OUTPUT INTERFACE 



IR 



R 



IS 


R 


UPD 


R 


IB 


R 




R 


SFLG 


B 


PQ-CUR-IB 


B 


PROC BUFFERS 


ABIT-ZBIT 


B 


BASE 


D 


MOD 


T 


SEPAR 


T 


SCO 


C 


SCI 


C 


SC2 


C 


PQBEG 


S 


PQEND 


S 


PBUFBEG 


S 


ISBEG 


S 


TKBEG 
i^QFLG 


S 
B 



Points to the (AM) preceding the next PROC statement to be 

executed; may be altered to change the location of PROC 

execution. 

May be altered to reflect a changed output buffer, but the 

formats described above must be maintained. For example, 

SFLG must be kept accurate. 

May be altered to reflect a changed output buffer, but the 

formats described above must be maintained. For example, 

PQ-CUR-BUF must be maintained. 

Set if "STACK ON" condition, otherwise zero. 

Set if secondary input buffer is active. Zero otherwise. 

Must be maintained in the formats described in the input 

section. Note that a (SM) must terminate each buffer. 

Zero. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

As at entry. 

Set if PROC execution is to continue. 



The normal method of returning control to PROC is to execute an external 
branch to 2, PROC- I. If it is necessary to abort PROC control and exit to WRAPUP, 
set PQFLG off, and execute an external branch to the appropriate WRAPUP entry 
point. 



1 PQNEXTOVF 

A subroutine called PQNEXTOVF is provided so that user written code may add 
parameters to the PROC buffers without concern about exceeding the buffers. 
This is applicable to the primary and secondary input buffers, and the secondary 
output buffer. Additional frames will be added to these buffers as needed. 
This subroutine handles a forward link zero trap on registers 15 or 8. It is 
called automatically when XMODE contains the mode-id 'PQNEXTOVF'. Note that 
R15 and R8 are not destroyed by this routine. 

2 INPUT INTERFACE 

R15 or R8 R Points to the end of the frame on which the forward link 

zero trap occurs. 
R9 R Set to PROC control block. 



3 OUTPUT INTERFACE 

""15 or R8 R As at entry, 
le output convention for ATTOVE is applicable 
"bVRFLW is if no frame was available. 



Note in particular that 



C.l 



PQ-INSERT is a subroutine which will insert single or multiple fields into 
any of the PROC buffers. 

INPUT INTERFACE: 
PBUF Points to first byte of receiving field. Sending field (s) must be 
terminated by an attribute mark. Multiple field inserts can be 
accomplished by separating the sending fields by blanks. 
IB Points to one byte before sending field 

SB2 - Causes blanks in sending field to be replaced by attribute marks 
in the receiving field. 
1 - Blanks are left as blanks 
R9 Points to PROC control frame (MOV PQ-REG,R9) 

OUTPUT INTERFACE: 
PBUF and IB Point to first byte of receiving field if SB2 = 1 
Point one byte before receiving field if SB2 = 

INTERNAL USAGE: 
BMS 
R14 
R15 



C.2 



